> ## Documentation Index > Fetch the complete documentation index at: https://docs.trackup.me/llms.txt > Use this file to discover all available pages before exploring further. # Get ad entity metrics > Requires ads-manager.read. accountIds, parentId and campaignIds use comma-separated strings. Selected accounts must share a currency. Synthetic query: `accountIds=11111111-1111-4111-8111-111111111111,55555555-5555-4555-8555-555555555555&startDate=2026-06-01T00%3A00%3A00Z&endDate=2026-06-02T23%3A59%3A59Z`. For ad sets, append `&level=adset&parentId=campaign-example-1,campaign-example-2`; campaignIds uses the same comma-separated format. ## OpenAPI ````yaml https://api.trackup.me/openapi.json get /v1/ads-manager/{projectId}/table openapi: 3.1.0 info: title: Trackup API description: >- API-key-accessible Trackup operations. Send your key in the `X-Api-Key` header. Keys belong to a team. `X-Team-Id` is not required; if supplied, it must match that team. Each operation lists its required key permission. The key creator must remain a team member and normally hold that permission. The ingest-only permissions `visitor.create`, `conversion.create`, and `request.create` do not need to be held by the creator. Project access and selection are described per operation. Session-only account, administration and OAuth operations are not part of this reference. The same operations are available as MCP tools at `/mcp` (Streamable HTTP). Authenticate with `X-Api-Key` or connect through OAuth, which issues an API key on consent. Schema validation errors return HTTP 422 with an `errors` object. Other errors generally contain `error` and `message`; operation-specific responses describe exceptions. version: 1.0.0 servers: - url: / description: Current API environment security: - ApiKey: [] paths: /v1/ads-manager/{projectId}/table: get: tags: - Ads manager summary: Get ad entity metrics description: >- Requires ads-manager.read. accountIds, parentId and campaignIds use comma-separated strings. Selected accounts must share a currency. Synthetic query: `accountIds=11111111-1111-4111-8111-111111111111,55555555-5555-4555-8555-555555555555&startDate=2026-06-01T00%3A00%3A00Z&endDate=2026-06-02T23%3A59%3A59Z`. For ad sets, append `&level=adset&parentId=campaign-example-1,campaign-example-2`; campaignIds uses the same comma-separated format. operationId: getAdsManagerTable parameters: - in: path name: projectId schema: type: string format: uuid required: true - in: query name: accountIds schema: type: string minLength: 1 required: true - in: query name: level schema: type: string enum: - campaign - adset - ad default: campaign - in: query name: parentId schema: type: string - in: query name: campaignIds schema: type: string - in: query name: startDate schema: type: string minLength: 1 required: true - in: query name: endDate schema: type: string minLength: 1 required: true - in: query name: search schema: type: string - in: query name: status schema: type: string responses: '200': description: Successful response. content: application/json: schema: $ref: '#/components/schemas/AdsManagerTable' '401': description: The X-Api-Key header is missing or the API key is invalid. content: application/json: schema: $ref: '#/components/schemas/ApiError' '403': description: >- The key is expired, revoked, lacks permission, or its creator no longer has the required team access. A conflicting X-Team-Id is also rejected. content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: >- The requested resource was not found or is outside the permitted scope. content: application/json: schema: $ref: '#/components/schemas/ApiError' '422': description: >- Invalid input, or selected ad accounts use different currencies (VALIDATION_ERROR). content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationError' - $ref: '#/components/schemas/ApiError' '500': description: An unexpected error occurred. content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: AdsManagerTable: type: object properties: rows: type: array items: type: object properties: entityId: type: string adAccountId: type: string entityType: type: string parentId: type: string name: type: string status: type: string objective: type: string dailyBudget: type: number lifetimeBudget: type: number spend: type: number impressions: type: number clicks: type: number linkClicks: type: number reach: type: number frequency: type: number cpm: type: number cpc: type: number ctr: type: number platformConversions: type: number platformConversionValue: type: number platformInitiateCheckouts: type: number platformInitiateCheckoutValue: type: number messagingConversations: type: number instagramFollows: type: number videoPlays: type: number video3sViews: type: number videoP75Views: type: number bidAmount: type: number platformCreatedAt: type: - string - 'null' platformUpdatedAt: type: - string - 'null' accountTotalSpend: type: number accountStatus: type: - number - 'null' trackedClicks: type: number uniqueVisitors: type: number sales: type: number revenue: type: number required: - entityId - adAccountId - entityType - parentId - name - status - objective - dailyBudget - lifetimeBudget - spend - impressions - clicks - linkClicks - reach - frequency - cpm - cpc - ctr - platformConversions - platformConversionValue - platformInitiateCheckouts - platformInitiateCheckoutValue - messagingConversations - instagramFollows - videoPlays - video3sViews - videoP75Views - bidAmount - platformCreatedAt - platformUpdatedAt - accountTotalSpend - accountStatus - trackedClicks - uniqueVisitors - sales - revenue required: - rows example: rows: - entityId: campaign-example adAccountId: 11111111-1111-4111-8111-111111111111 entityType: campaign parentId: '' name: Example status: ACTIVE objective: OUTCOME_SALES dailyBudget: 15 lifetimeBudget: 0 spend: 25 impressions: 100 clicks: 5 linkClicks: 4 reach: 80 frequency: 1.25 cpm: 250 cpc: 5 ctr: 5 platformConversions: 1 platformConversionValue: 49.9 platformInitiateCheckouts: 1 platformInitiateCheckoutValue: 1 messagingConversations: 1 instagramFollows: 1 videoPlays: 1 video3sViews: 1 videoP75Views: 1 bidAmount: 1 platformCreatedAt: null platformUpdatedAt: null accountTotalSpend: 25 accountStatus: null trackedClicks: 3 uniqueVisitors: 2 sales: 1 revenue: 49.9 ApiError: type: object properties: error: type: string message: type: string required: - error - message additionalProperties: true ValidationError: type: object properties: errors: type: object additionalProperties: type: string required: - errors securitySchemes: ApiKey: type: apiKey in: header name: X-Api-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.