> ## 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.

# List ads in a workspace



## OpenAPI

````yaml https://api.revinel.com/v1/openapi.json get /workspaces/{workspaceId}/ads
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}/ads:
    get:
      tags:
        - Ads (Beta)
      summary: List ads in a workspace
      operationId: ads.list
      parameters:
        - name: workspaceId
          in: path
          required: true
          schema:
            type: string
        - name: status
          in: query
          schema:
            enum:
              - Pending
              - Approved
              - Rejected
            type: string
            description: Filter by review status.
          allowEmptyValue: true
          allowReserved: true
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 9007199254740991
            default: 1
          allowEmptyValue: true
          allowReserved: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    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
                        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
                            advertiser:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                email:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                              required:
                                - id
                                - name
                                - email
                          required:
                            - id
                            - status
                            - cancelAtPeriodEnd
                            - currentPeriodStart
                            - currentPeriodEnd
                            - paidAmount
                            - tier
                            - tierPrice
                            - advertiser
                      required:
                        - id
                        - status
                        - name
                        - websiteUrl
                        - faviconUrl
                        - reviewedAt
                        - rejectionNote
                        - createdAt
                        - updatedAt
                        - subscription
                  total:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: Total rows across all pages.
                  page:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: The (clamped) page returned.
                  perPage:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: Rows per page.
                  pageCount:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: Total number of pages.
                required:
                  - items
                  - total
                  - page
                  - perPage
                  - pageCount
        '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

````