openapi: 3.1.0
info:
  title: 'Worldvectorlogo API'
  description: 'Programmatic access to thousands of professionally curated vector logos in SVG format.'
  version: 1.0.0
servers:
  -
    url: 'https://worldvectorlogo.com'
tags:
  -
    name: Logo
    description: "\nBrowse, search, and retrieve vector logos."
  -
    name: Tag
    description: "\nExplore logos organised by tags."
  -
    name: Account
    description: "\nManage your API key and view usage statistics. Requires authentication."
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: "The API works **without authentication** — every endpoint is accessible anonymously with a limit of **10 requests per day** (per IP).\n\nFor higher limits, create a free account at [worldvectorlogo.com](https://worldvectorlogo.com) and generate an API key under **Account → API Keys**.\n\n**Bearer header (recommended):**\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n\n**Query parameter** (useful when headers aren't convenient, e.g. `<img>` tags):\n```\n/api/v1/logos?api_key=YOUR_API_KEY\n```"
security:
  -
    default: []
paths:
  /api/v1/logos:
    get:
      summary: 'List all logos.'
      operationId: listAllLogos
      description: "Browse all published logos with optional sorting.\nResults are paginated with a default of 20 per page."
      parameters:
        -
          in: query
          name: page
          description: 'Page number.'
          required: false
          schema:
            type: integer
            description: 'Page number.'
            examples:
              - 1
        -
          in: query
          name: per_page
          description: 'Results per page (1-50).'
          required: false
          schema:
            type: integer
            description: 'Results per page (1-50).'
            examples:
              - 20
        -
          in: query
          name: sort
          description: 'Sort field: downloads, created.'
          required: false
          schema:
            type: string
            description: 'Sort field: downloads, created.'
            examples:
              - downloads
        -
          in: query
          name: order
          description: 'Sort direction: asc, desc.'
          required: false
          schema:
            type: string
            description: 'Sort direction: asc, desc.'
            examples:
              - desc
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: 'List of logo objects.'
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - google-2015
                        name:
                          type: string
                          examples:
                            - 'Google 2015'
                        downloads:
                          type: integer
                          examples:
                            - 48230
                        svg_url:
                          type: string
                          examples:
                            - 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          type: array
                          items:
                            type: string
                          examples:
                            -
                              - technology
                              - search-engine
                        created_at:
                          type: string
                          examples:
                            - '2024-01-15T10:30:00+00:00'
                        updated_at:
                          type: string
                          examples:
                            - '2024-06-20T14:15:00+00:00'
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/logo/google-2015'
                    examples:
                      -
                        -
                          slug: google-2015
                          name: 'Google 2015'
                          downloads: 48230
                          svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                          tags:
                            - technology
                            - search-engine
                          created_at: '2024-01-15T10:30:00+00:00'
                          updated_at: '2024-06-20T14:15:00+00:00'
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web: 'https://worldvectorlogo.com/logo/google-2015'
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos?page=1'
                      last:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos?page=100'
                      prev:
                        type:
                          - string
                          - 'null'
                        examples:
                          - null
                      next:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos?page=2'
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        examples:
                          - 1
                      from:
                        type: integer
                        examples:
                          - 1
                      last_page:
                        type: integer
                        examples:
                          - 100
                      per_page:
                        type: integer
                        examples:
                          - 20
                      to:
                        type: integer
                        examples:
                          - 20
                      total:
                        type: integer
                        examples:
                          - 2000
                    description: 'Pagination metadata.'
                examples:
                  -
                    data:
                      -
                        slug: google-2015
                        name: 'Google 2015'
                        downloads: 48230
                        svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          - technology
                          - search-engine
                        created_at: '2024-01-15T10:30:00+00:00'
                        updated_at: '2024-06-20T14:15:00+00:00'
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                          web: 'https://worldvectorlogo.com/logo/google-2015'
                    links:
                      first: 'https://worldvectorlogo.com/api/v1/logos?page=1'
                      last: 'https://worldvectorlogo.com/api/v1/logos?page=100'
                      prev: null
                      next: 'https://worldvectorlogo.com/api/v1/logos?page=2'
                    meta:
                      current_page: 1
                      from: 1
                      last_page: 100
                      per_page: 20
                      to: 20
                      total: 2000
      tags:
        - Logo
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                page:
                  type: integer
                  description: 'Must be at least 1. Must not be greater than 100.'
                  examples:
                    - 1
                per_page:
                  type: integer
                  description: 'Must be at least 1. Must not be greater than 50.'
                  examples:
                    - 22
                sort:
                  type: string
                  description: ''
                  enum:
                    - downloads
                    - created
                  examples:
                    - downloads
                order:
                  type: string
                  description: ''
                  enum:
                    - asc
                    - desc
                  examples:
                    - asc
      security: []
  /api/v1/logos/search:
    get:
      summary: 'Search logos by name.'
      operationId: searchLogosByName
      description: "Search across logo names and slugs using a query string.\nResults are ordered by download count (most popular first)."
      parameters:
        -
          in: query
          name: q
          description: 'Search query.'
          required: true
          schema:
            type: string
            description: 'Search query.'
            examples:
              - google
        -
          in: query
          name: page
          description: 'Page number.'
          required: false
          schema:
            type: integer
            description: 'Page number.'
            examples:
              - 1
        -
          in: query
          name: per_page
          description: 'Results per page (1-50).'
          required: false
          schema:
            type: integer
            description: 'Results per page (1-50).'
            examples:
              - 20
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - google-2015
                        name:
                          type: string
                          examples:
                            - 'Google 2015'
                        downloads:
                          type: integer
                          examples:
                            - 48230
                        svg_url:
                          type: string
                          examples:
                            - 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          type: array
                          items:
                            type: string
                          examples:
                            -
                              - technology
                              - search-engine
                        created_at:
                          type: string
                          examples:
                            - '2024-01-15T10:30:00+00:00'
                        updated_at:
                          type: string
                          examples:
                            - '2024-06-20T14:15:00+00:00'
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/logo/google-2015'
                    examples:
                      -
                        -
                          slug: google-2015
                          name: 'Google 2015'
                          downloads: 48230
                          svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                          tags:
                            - technology
                            - search-engine
                          created_at: '2024-01-15T10:30:00+00:00'
                          updated_at: '2024-06-20T14:15:00+00:00'
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web: 'https://worldvectorlogo.com/logo/google-2015'
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos/search?q=google&page=1'
                      last:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos/search?q=google&page=1'
                      prev:
                        type:
                          - string
                          - 'null'
                        examples:
                          - null
                      next:
                        type:
                          - string
                          - 'null'
                        examples:
                          - null
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        examples:
                          - 1
                      from:
                        type: integer
                        examples:
                          - 1
                      last_page:
                        type: integer
                        examples:
                          - 1
                      per_page:
                        type: integer
                        examples:
                          - 20
                      to:
                        type: integer
                        examples:
                          - 3
                      total:
                        type: integer
                        examples:
                          - 3
                examples:
                  -
                    data:
                      -
                        slug: google-2015
                        name: 'Google 2015'
                        downloads: 48230
                        svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          - technology
                          - search-engine
                        created_at: '2024-01-15T10:30:00+00:00'
                        updated_at: '2024-06-20T14:15:00+00:00'
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                          web: 'https://worldvectorlogo.com/logo/google-2015'
                    links:
                      first: 'https://worldvectorlogo.com/api/v1/logos/search?q=google&page=1'
                      last: 'https://worldvectorlogo.com/api/v1/logos/search?q=google&page=1'
                      prev: null
                      next: null
                    meta:
                      current_page: 1
                      from: 1
                      last_page: 1
                      per_page: 20
                      to: 3
                      total: 3
        422:
          description: 'Validation error'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        examples:
                          - validation_error
                      message:
                        type: string
                        examples:
                          - 'The given data was invalid.'
                      details:
                        type: object
                        properties:
                          q:
                            type: array
                            items:
                              type: string
                            examples:
                              -
                                - 'The q field is required.'
                examples:
                  -
                    error:
                      code: validation_error
                      message: 'The given data was invalid.'
                      details:
                        q:
                          - 'The q field is required.'
      tags:
        - Logo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                q:
                  type: string
                  description: 'Must be at least 1 character. Must not be greater than 200 characters.'
                  examples:
                    - b
                page:
                  type: integer
                  description: 'Must be at least 1. Must not be greater than 100.'
                  examples:
                    - 22
                per_page:
                  type: integer
                  description: 'Must be at least 1. Must not be greater than 50.'
                  examples:
                    - 7
              required:
                - q
      security: []
  /api/v1/logos/random:
    get:
      summary: 'Get random logos.'
      operationId: getRandomLogos
      description: 'Returns a random selection of logos. Useful for showcases or demos.'
      parameters:
        -
          in: query
          name: count
          description: 'Number of logos (1-20).'
          required: false
          schema:
            type: integer
            description: 'Number of logos (1-20).'
            examples:
              - 5
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - spotify-2015
                        name:
                          type: string
                          examples:
                            - 'Spotify 2015'
                        downloads:
                          type: integer
                          examples:
                            - 12500
                        svg_url:
                          type: string
                          examples:
                            - 'https://cdn.worldvectorlogo.com/logos/spotify-2015.svg'
                        tags:
                          type: array
                          items:
                            type: string
                          examples:
                            -
                              - music
                              - streaming
                        created_at:
                          type: string
                          examples:
                            - '2024-02-10T08:00:00+00:00'
                        updated_at:
                          type: string
                          examples:
                            - '2024-05-15T12:00:00+00:00'
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/logos/spotify-2015'
                            web:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/logo/spotify-2015'
                    examples:
                      -
                        -
                          slug: spotify-2015
                          name: 'Spotify 2015'
                          downloads: 12500
                          svg_url: 'https://cdn.worldvectorlogo.com/logos/spotify-2015.svg'
                          tags:
                            - music
                            - streaming
                          created_at: '2024-02-10T08:00:00+00:00'
                          updated_at: '2024-05-15T12:00:00+00:00'
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/logos/spotify-2015'
                            web: 'https://worldvectorlogo.com/logo/spotify-2015'
                examples:
                  -
                    data:
                      -
                        slug: spotify-2015
                        name: 'Spotify 2015'
                        downloads: 12500
                        svg_url: 'https://cdn.worldvectorlogo.com/logos/spotify-2015.svg'
                        tags:
                          - music
                          - streaming
                        created_at: '2024-02-10T08:00:00+00:00'
                        updated_at: '2024-05-15T12:00:00+00:00'
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/logos/spotify-2015'
                          web: 'https://worldvectorlogo.com/logo/spotify-2015'
      tags:
        - Logo
      security: []
  '/api/v1/logos/{slug}':
    get:
      summary: 'Get a single logo by slug.'
      operationId: getASingleLogoBySlug
      description: "Returns full details for a specific logo including tags and raw SVG content.\nThe `svg_content` field contains the full SVG markup that you can embed,\ntransform, or offer as a download in your application."
      parameters: []
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      slug:
                        type: string
                        description: 'Unique URL-safe identifier.'
                        examples:
                          - google-2015
                      name:
                        type: string
                        description: 'Display name of the logo.'
                        examples:
                          - 'Google 2015'
                      downloads:
                        type: integer
                        description: 'Total download count.'
                        examples:
                          - 48230
                      svg_url:
                        type: string
                        description: 'Direct CDN link to the SVG file.'
                        examples:
                          - 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                      svg_content:
                        type: string
                        description: 'Full SVG markup (only on single-logo endpoint).'
                        examples:
                          - '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 272 92">...</svg>'
                      tags:
                        type: array
                        description: 'Tag names associated with this logo.'
                        items:
                          type: string
                        examples:
                          -
                            - technology
                            - search-engine
                      created_at:
                        type: string
                        examples:
                          - '2024-01-15T10:30:00+00:00'
                      updated_at:
                        type: string
                        examples:
                          - '2024-06-20T14:15:00+00:00'
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                            examples:
                              - 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                          web:
                            type: string
                            examples:
                              - 'https://worldvectorlogo.com/logo/google-2015'
                        description: 'HATEOAS links (self, web).'
                examples:
                  -
                    data:
                      slug: google-2015
                      name: 'Google 2015'
                      downloads: 48230
                      svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                      svg_content: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 272 92">...</svg>'
                      tags:
                        - technology
                        - search-engine
                      created_at: '2024-01-15T10:30:00+00:00'
                      updated_at: '2024-06-20T14:15:00+00:00'
                      links:
                        self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                        web: 'https://worldvectorlogo.com/logo/google-2015'
        404:
          description: 'Not found'
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    examples:
                      - 'Not Found.'
                examples:
                  -
                    message: 'Not Found.'
      tags:
        - Logo
      security: []
    parameters:
      -
        in: path
        name: slug
        description: 'The logo slug.'
        required: true
        schema:
          type: string
          examples:
            - google-2015
  /api/v1/tags:
    get:
      summary: 'List all tags.'
      operationId: listAllTags
      description: "Returns all tags with their logo counts.\nSorted alphabetically by name."
      parameters: []
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - technology
                        name:
                          type: string
                          examples:
                            - Technology
                        logos_count:
                          type: integer
                          examples:
                            - 245
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/tags/technology'
                            logos:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/tags/technology/logos'
                    examples:
                      -
                        -
                          slug: technology
                          name: Technology
                          logos_count: 245
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/tags/technology'
                            logos: 'https://worldvectorlogo.com/api/v1/tags/technology/logos'
                        -
                          slug: automotive
                          name: Automotive
                          logos_count: 89
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/tags/automotive'
                            logos: 'https://worldvectorlogo.com/api/v1/tags/automotive/logos'
                examples:
                  -
                    data:
                      -
                        slug: technology
                        name: Technology
                        logos_count: 245
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/tags/technology'
                          logos: 'https://worldvectorlogo.com/api/v1/tags/technology/logos'
                      -
                        slug: automotive
                        name: Automotive
                        logos_count: 89
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/tags/automotive'
                          logos: 'https://worldvectorlogo.com/api/v1/tags/automotive/logos'
      tags:
        - Tag
      security: []
  '/api/v1/tags/{slug}/logos':
    get:
      summary: 'Get logos for a specific tag.'
      operationId: getLogosForASpecificTag
      description: 'Returns all published logos that have the given tag.'
      parameters:
        -
          in: query
          name: page
          description: 'Page number.'
          required: false
          schema:
            type: integer
            description: 'Page number.'
            examples:
              - 1
        -
          in: query
          name: per_page
          description: 'Results per page (1-50).'
          required: false
          schema:
            type: integer
            description: 'Results per page (1-50).'
            examples:
              - 20
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - google-2015
                        name:
                          type: string
                          examples:
                            - 'Google 2015'
                        downloads:
                          type: integer
                          examples:
                            - 48230
                        svg_url:
                          type: string
                          examples:
                            - 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          type: array
                          items:
                            type: string
                          examples:
                            -
                              - technology
                              - search-engine
                        created_at:
                          type: string
                          examples:
                            - '2024-01-15T10:30:00+00:00'
                        updated_at:
                          type: string
                          examples:
                            - '2024-06-20T14:15:00+00:00'
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/logo/google-2015'
                    examples:
                      -
                        -
                          slug: google-2015
                          name: 'Google 2015'
                          downloads: 48230
                          svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                          tags:
                            - technology
                            - search-engine
                          created_at: '2024-01-15T10:30:00+00:00'
                          updated_at: '2024-06-20T14:15:00+00:00'
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web: 'https://worldvectorlogo.com/logo/google-2015'
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/tags/technology/logos?page=1'
                      last:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/tags/technology/logos?page=13'
                      prev:
                        type:
                          - string
                          - 'null'
                        examples:
                          - null
                      next:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/tags/technology/logos?page=2'
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        examples:
                          - 1
                      from:
                        type: integer
                        examples:
                          - 1
                      last_page:
                        type: integer
                        examples:
                          - 13
                      per_page:
                        type: integer
                        examples:
                          - 20
                      to:
                        type: integer
                        examples:
                          - 20
                      total:
                        type: integer
                        examples:
                          - 245
                examples:
                  -
                    data:
                      -
                        slug: google-2015
                        name: 'Google 2015'
                        downloads: 48230
                        svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          - technology
                          - search-engine
                        created_at: '2024-01-15T10:30:00+00:00'
                        updated_at: '2024-06-20T14:15:00+00:00'
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                          web: 'https://worldvectorlogo.com/logo/google-2015'
                    links:
                      first: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?page=1'
                      last: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?page=13'
                      prev: null
                      next: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?page=2'
                    meta:
                      current_page: 1
                      from: 1
                      last_page: 13
                      per_page: 20
                      to: 20
                      total: 245
        404:
          description: 'Tag not found'
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    examples:
                      - 'Not Found.'
                examples:
                  -
                    message: 'Not Found.'
      tags:
        - Tag
      security: []
    parameters:
      -
        in: path
        name: slug
        description: 'The tag slug.'
        required: true
        schema:
          type: string
          examples:
            - technology
  /api/v1/account/usage:
    get:
      summary: 'Get API usage statistics.'
      operationId: getAPIUsageStatistics
      description: "Returns daily usage breakdown for the current billing period (last 30 days).\nIncludes total requests, remaining quota, and per-endpoint breakdown."
      parameters: []
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      plan:
                        type: string
                        description: 'Your current plan tier (free or pro).'
                        examples:
                          - free
                      today:
                        type: object
                        properties:
                          used:
                            type: integer
                            description: 'Requests made today.'
                            examples:
                              - 42
                          limit:
                            type: integer
                            description: 'Your daily request quota.'
                            examples:
                              - 500
                          remaining:
                            type: integer
                            description: 'Requests remaining today.'
                            examples:
                              - 458
                          resets_at:
                            type: string
                            description: 'ISO 8601 timestamp when the quota resets.'
                            examples:
                              - '2026-04-06T23:59:59+00:00'
                        description: "Today's usage summary."
                      tokens:
                        type: integer
                        description: 'Number of active API tokens.'
                        examples:
                          - 1
                      daily_breakdown:
                        type: object
                        properties:
                          '2026-04-06':
                            type: object
                            properties:
                              requests:
                                type: integer
                                examples:
                                  - 42
                              errors:
                                type: integer
                                examples:
                                  - 0
                              avg_response_time_ms:
                                type: integer
                                examples:
                                  - 28
                          '2026-04-05':
                            type: object
                            properties:
                              requests:
                                type: integer
                                examples:
                                  - 150
                              errors:
                                type: integer
                                examples:
                                  - 2
                              avg_response_time_ms:
                                type: integer
                                examples:
                                  - 35
                        description: 'Daily usage data keyed by date.'
                examples:
                  -
                    data:
                      plan: free
                      today:
                        used: 42
                        limit: 500
                        remaining: 458
                        resets_at: '2026-04-06T23:59:59+00:00'
                      tokens: 1
                      daily_breakdown:
                        '2026-04-06':
                          requests: 42
                          errors: 0
                          avg_response_time_ms: 28
                        '2026-04-05':
                          requests: 150
                          errors: 2
                          avg_response_time_ms: 35
        401:
          description: Unauthenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    examples:
                      - Unauthenticated.
                examples:
                  -
                    message: Unauthenticated.
      tags:
        - Account
