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

> Returns all boards belonging to the authenticated user, ordered by most recently updated.



## OpenAPI

````yaml GET /v1/boards
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/boards:
    get:
      summary: Get user boards
      description: >-
        Returns all boards belonging to the authenticated user, ordered by most
        recently updated.
      operationId: getBoards
      parameters:
        - name: space_id
          in: query
          description: >-
            Filter boards by space. Omit to return all boards. Pass an empty
            string to return boards not assigned to any space.
          schema:
            type: string
          example: 0133afa6-5326-4a70-aa10-c9358eb6de04
      responses:
        '200':
          description: List of boards.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  boards:
                    type: array
                    items:
                      $ref: '#/components/schemas/Board'
              example:
                count: 2
                boards:
                  - board_id: 00116792-d6d1-444f-a841-80dd3c105ae7
                    name: My First Board
                    is_public: false
                    space_id: null
                    created_at: '2026-02-04T01:15:23Z'
                    updated_at: '2026-02-04T01:30:33Z'
                  - board_id: 11227893-e7e2-555g-b952-91ee4d216bf8
                    name: Top Performers
                    is_public: false
                    space_id: 0133afa6-5326-4a70-aa10-c9358eb6de04
                    created_at: '2026-03-01T10:00:00Z'
                    updated_at: '2026-04-15T14:22: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:
    Board:
      type: object
      properties:
        board_id:
          type: string
          format: uuid
        name:
          type: string
        is_public:
          type: boolean
        space_id:
          type: string
          format: uuid
          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.

````