> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adspo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get user spaces

> Returns all spaces belonging to the authenticated user.



## OpenAPI

````yaml GET /v1/spaces
openapi: 3.1.0
info:
  title: Adspo API
  version: 1.0.0
  description: >
    The Adspo API gives you programmatic access to ad creative data across
    brands.


    ## Authentication


    All endpoints require an API key passed in the `x-api-key` header.


    ```

    x-api-key: YOUR_API_KEY

    ```


    ## Rate limits


    - **120 requests per minute** per key. Exceeding this returns `429`.

    - **Credits per billing period** vary by plan. Each request costs 1 credit.
    Exceeding your quota returns `429` with `resets_at` indicating when it
    resets
servers:
  - url: https://api.adspo.co
    description: Production
security:
  - apiKey: []
paths:
  /v1/spaces:
    get:
      summary: Get user spaces
      description: Returns all spaces belonging to the authenticated user.
      operationId: getSpaces
      responses:
        '200':
          description: List of spaces.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  spaces:
                    type: array
                    items:
                      $ref: '#/components/schemas/Space'
              example:
                count: 2
                spaces:
                  - space_id: 0133afa6-5326-4a70-aa10-c9358eb6de04
                    name: Client A
                    image_uri: null
                    created_at: '2026-04-16T18:17:20Z'
                    updated_at: '2026-04-16T18:17:20Z'
                  - space_id: 1244bfa6-6437-5b81-bb21-d0469fc7be15
                    name: Client B
                    image_uri: null
                    created_at: '2026-03-10T09:00:00Z'
                    updated_at: '2026-03-10T09:00:00Z'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit or quota exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Space:
      type: object
      properties:
        space_id:
          type: string
          format: uuid
          description: Unique identifier for this space.
        name:
          type: string
        image_uri:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        error:
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Adspo API key.

````