> ## Documentation Index > Fetch the complete documentation index at: https://docs.omnichar.org/llms.txt > Use this file to discover all available pages before exploring further. # Get a character’s usage ## OpenAPI ````yaml /api/openapi.json get /v1/chars/{id}/usage openapi: 3.1.0 info: title: Omnichar API version: 0.1.0 description: Characters, licenses, public license verification and signed webhooks. servers: - url: https://api.omnichar.org security: - bearer: [] paths: /v1/chars/{id}/usage: get: tags: - Usage summary: Get a character’s usage parameters: - schema: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ - type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ in: query name: from required: false - schema: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ - type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ in: query name: to required: false - schema: type: string enum: - allowed - blocked in: query name: result required: false - schema: type: string enum: - image - video - voice - char in: query name: media required: false - schema: type: string enum: - cloud - api - app - download in: query name: surface required: false - schema: type: string maxLength: 200 in: query name: cursor required: false - schema: default: 50 type: integer minimum: 1 maximum: 200 in: query name: limit required: false - schema: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ in: path name: id required: true responses: '200': description: Default Response content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ env: type: string enum: - production - sandbox license_key: type: - string - 'null' char_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ team_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ provider_team_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ surface: type: string enum: - cloud - api - app - download media: anyOf: - type: string enum: - image - video - voice - char - type: 'null' use: type: - string - 'null' territory: type: - string - 'null' result: type: string enum: - allowed - blocked reason: type: - string - 'null' run_id: anyOf: - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - type: 'null' output_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 output_hashes: type: array items: type: string credits_charged: type: number created_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ updated_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ required: - id - env - license_key - char_id - team_id - provider_team_id - surface - media - use - territory - result - reason - run_id - output_count - output_hashes - credits_charged - created_at - updated_at additionalProperties: false next_cursor: type: - string - 'null' totals: type: object properties: allowed: type: integer minimum: -9007199254740991 maximum: 9007199254740991 blocked: type: integer minimum: -9007199254740991 maximum: 9007199254740991 outputs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 downloads: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - allowed - blocked - outputs - downloads additionalProperties: false days: type: array items: type: object properties: day: type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ allowed: type: integer minimum: -9007199254740991 maximum: 9007199254740991 blocked: type: integer minimum: -9007199254740991 maximum: 9007199254740991 outputs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - day - allowed - blocked - outputs additionalProperties: false required: - items - next_cursor - totals - days additionalProperties: false components: securitySchemes: bearer: type: http scheme: bearer description: 'A team key: sk_test_ for sandbox, sk_live_ for production.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.