> ## Documentation Index > Fetch the complete documentation index at: https://revinel.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get an advertiser with their ads and revenue totals ## OpenAPI ````yaml https://api.revinel.com/v1/openapi.json get /workspaces/{workspaceId}/advertisers/{advertiserId} openapi: 3.1.1 info: title: Revinel API version: 1.0.0 description: >- Public surface of the Revinel platform. Consumed by `@revinel/sdk` and `@revinel/react`. **Errors** are returned as an oRPC envelope: `{ defined: boolean, code: string, status: number, message: string, data?: object }`. Input-validation failures return HTTP **422** with `code: "INPUT_VALIDATION_FAILED"` and `data.fieldErrors` / `data.formErrors`. servers: - url: https://api.revinel.com/v1 security: [] paths: /workspaces/{workspaceId}/advertisers/{advertiserId}: get: tags: - Advertisers (Beta) summary: Get an advertiser with their ads and revenue totals operationId: advertisers.get parameters: - name: workspaceId in: path required: true schema: type: string - name: advertiserId in: path required: true schema: type: string minLength: 1 responses: '200': description: OK content: application/json: schema: type: object properties: id: type: string name: type: string email: anyOf: - type: string - type: 'null' createdAt: type: string format: date-time x-native-type: date updatedAt: type: string format: date-time x-native-type: date totals: type: object properties: ads: type: integer minimum: -9007199254740991 maximum: 9007199254740991 activeAds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 activeSubscriptions: type: integer minimum: -9007199254740991 maximum: 9007199254740991 impressions: type: integer minimum: -9007199254740991 maximum: 9007199254740991 clicks: type: integer minimum: -9007199254740991 maximum: 9007199254740991 monthlyAmount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Normalized monthly revenue in the smallest currency unit. lifetimeAmount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Estimated lifetime billing across every subscription, in the smallest currency unit. currency: type: string nextRenewalAt: anyOf: - type: string format: date-time x-native-type: date - type: 'null' description: When the soonest serving subscription next renews. churnedAt: anyOf: - type: string format: date-time x-native-type: date - type: 'null' description: >- When the advertiser's last subscription lapsed, once fully churned. required: - ads - activeAds - activeSubscriptions - impressions - clicks - monthlyAmount - lifetimeAmount - currency - nextRenewalAt - churnedAt latestAd: anyOf: - type: object properties: id: type: string status: enum: - Pending - Approved - Rejected type: string name: type: string websiteUrl: type: string faviconUrl: anyOf: - type: string - type: 'null' description: Favicon URL, or null when none was found. reviewedAt: anyOf: - type: string format: date-time x-native-type: date - type: 'null' rejectionNote: anyOf: - type: string - type: 'null' createdAt: type: string format: date-time x-native-type: date updatedAt: type: string format: date-time x-native-type: date stats: type: object properties: impressions: type: integer minimum: -9007199254740991 maximum: 9007199254740991 clicks: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - impressions - clicks subscription: type: object properties: id: type: string status: enum: - Trialing - Active - PastDue - Canceled - Unpaid - Incomplete - IncompleteExpired - Paused type: string description: >- Billing status of the advertiser's subscription. cancelAtPeriodEnd: type: boolean currentPeriodStart: anyOf: - type: string format: date-time x-native-type: date - type: 'null' currentPeriodEnd: anyOf: - type: string format: date-time x-native-type: date - type: 'null' paidAmount: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Real post-discount charge in the smallest unit; null when unknown. tier: type: object properties: id: type: string name: type: string weight: type: number required: - id - name - weight tierPrice: type: object properties: id: type: string interval: enum: - Day - Week - Month - Year type: string description: >- Billing interval: Day, Week, Month, or Year. intervalCount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Number of intervals per billing cycle (usually 1). amount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Price in the smallest currency unit (e.g. cents). currency: type: string description: ISO 4217 currency code (e.g. `usd`). required: - id - interval - intervalCount - amount - currency createdAt: type: string format: date-time x-native-type: date updatedAt: type: string format: date-time x-native-type: date required: - id - status - cancelAtPeriodEnd - currentPeriodStart - currentPeriodEnd - paidAmount - tier - tierPrice - createdAt - updatedAt required: - id - status - name - websiteUrl - faviconUrl - reviewedAt - rejectionNote - createdAt - updatedAt - stats - subscription - type: 'null' ads: type: array items: type: object properties: id: type: string status: enum: - Pending - Approved - Rejected type: string name: type: string websiteUrl: type: string faviconUrl: anyOf: - type: string - type: 'null' description: Favicon URL, or null when none was found. reviewedAt: anyOf: - type: string format: date-time x-native-type: date - type: 'null' rejectionNote: anyOf: - type: string - type: 'null' createdAt: type: string format: date-time x-native-type: date updatedAt: type: string format: date-time x-native-type: date stats: type: object properties: impressions: type: integer minimum: -9007199254740991 maximum: 9007199254740991 clicks: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - impressions - clicks subscription: type: object properties: id: type: string status: enum: - Trialing - Active - PastDue - Canceled - Unpaid - Incomplete - IncompleteExpired - Paused type: string description: Billing status of the advertiser's subscription. cancelAtPeriodEnd: type: boolean currentPeriodStart: anyOf: - type: string format: date-time x-native-type: date - type: 'null' currentPeriodEnd: anyOf: - type: string format: date-time x-native-type: date - type: 'null' paidAmount: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Real post-discount charge in the smallest unit; null when unknown. tier: type: object properties: id: type: string name: type: string weight: type: number required: - id - name - weight tierPrice: type: object properties: id: type: string interval: enum: - Day - Week - Month - Year type: string description: 'Billing interval: Day, Week, Month, or Year.' intervalCount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Number of intervals per billing cycle (usually 1). amount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Price in the smallest currency unit (e.g. cents). currency: type: string description: ISO 4217 currency code (e.g. `usd`). required: - id - interval - intervalCount - amount - currency createdAt: type: string format: date-time x-native-type: date updatedAt: type: string format: date-time x-native-type: date required: - id - status - cancelAtPeriodEnd - currentPeriodStart - currentPeriodEnd - paidAmount - tier - tierPrice - createdAt - updatedAt required: - id - status - name - websiteUrl - faviconUrl - reviewedAt - rejectionNote - createdAt - updatedAt - stats - subscription required: - id - name - email - createdAt - updatedAt - totals - latestAd - ads '409': description: '409' content: application/json: schema: oneOf: - type: object properties: defined: const: true code: const: CONFLICT_FIELD status: const: 409 message: type: string default: CONFLICT_FIELD data: type: object properties: formErrors: type: array items: type: string fieldErrors: type: object propertyNames: type: string additionalProperties: type: array items: type: string required: - formErrors - fieldErrors required: - defined - code - status - message - data - type: object properties: defined: const: false code: type: string status: type: number message: type: string data: {} required: - defined - code - status - message '422': description: '422' content: application/json: schema: oneOf: - type: object properties: defined: const: true code: const: INPUT_VALIDATION_FAILED status: const: 422 message: type: string default: INPUT_VALIDATION_FAILED data: type: object properties: formErrors: type: array items: type: string fieldErrors: type: object propertyNames: type: string additionalProperties: type: array items: type: string required: - formErrors - fieldErrors required: - defined - code - status - message - data - type: object properties: defined: const: false code: type: string status: type: number message: type: string data: {} required: - defined - code - status - message ````