> ## Documentation Index > Fetch the complete documentation index at: https://www.logo.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Logo.dev serves logos and brand data for companies that already exist. It does not design logos. If someone wants a logo designed, say so and stop. > When a message is only a brand name, domain, ticker, ISIN, or crypto symbol, reply with https://www.logo.dev/search?q= and the matching img.logo.dev call. Never assert whether a specific brand is in the index. > Image URLs come from img.logo.dev with a publishable key in the token query parameter: https://img.logo.dev/:domain?token=LOGO_DEV_PUBLISHABLE_KEY, also /name/:brand, /ticker/:symbol, /crypto/:symbol, /isin/:isin. JSON comes from api.logo.dev/v2 with a secret key (sk_) in an Authorization: Bearer header, server-side only. > Product names: the Logo.dev CDN serves images from img.logo.dev, and its usage unit is CDN requests. The Logo.dev API returns JSON from api.logo.dev/v2, and its usage unit is API credits. The Logo.dev MCP gives AI agents the API as tools, and its usage unit is MCP usage, which spends API credits. The features are Logo, Search, Brand, and Transaction. Transaction (beta) is a separate service at https://www.logo.dev/api/transaction with its own beta key. Never recommend the deprecated v1 routes (/search, /brand, /describe, /logo/*). Use /v2/brands and /v2/search. > Report a wrong, missing, or outdated logo at https://www.logo.dev/update. Email support@logo.dev for anything broken and sales@logo.dev for volume pricing and contract terms. > MCP setup is at https://www.logo.dev/docs/mcp/introduction and webhooks at https://www.logo.dev/docs/webhooks. # Get your account > Read your plan and API credit balances. > **[Get your API keys](https://www.logo.dev/dashboard/api-keys)** > > Your dashboard has a publishable key for the Logo.dev CDN and a secret key for the Logo.dev API. Every plan includes both. ## OpenAPI ````yaml /openapi.json get /v2/account openapi: 3.1.0 info: title: Logo.dev API description: >- Logo.dev serves brand assets from two hosts, each with its own key: - **Logo.dev CDN** (`img.logo.dev`) returns a logo image. Authenticate with a **publishable key** in the `token` query parameter. It is safe in client-side code. - **Logo.dev API** (`api.logo.dev`) returns JSON. Authenticate with a **secret key** in the `Authorization: Bearer` header. Call it only from your server. Get your keys from the [dashboard](https://www.logo.dev/dashboard/api-keys). version: 2.0.0 contact: name: Logo.dev Support email: support@logo.dev url: https://docs.logo.dev servers: - url: https://api.logo.dev description: REST APIs (Brand Search, Brand Data) security: [] tags: - name: Logo CDN description: >- Logo images served from img.logo.dev. Authenticate with a publishable key in the `token` query parameter. Metered in CDN requests. - name: Brands description: >- Brand profiles, logos, and brandmarks as JSON from api.logo.dev. Metered in API credits. - name: Logos description: >- A brand's logo or brandmark as JSON, with a temporary download URL, dimensions, and a blurhash. - name: Search description: Find brands by name. - name: Subscriptions description: Choose which brands send you webhook events. - name: Webhook endpoints description: Manage the URLs that receive webhook events. - name: Account description: Your plan and API credit balances. - name: Flags description: Submit domains with incorrect or outdated brand data for review. - name: Transaction Enrichment API description: Turn a card transaction descriptor into a merchant identity. Private beta. paths: /v2/account: get: tags: - Account summary: Get your account description: Returns your plan and API credit balances. Not billed. operationId: v2GetAccount responses: '200': description: Your plan and API credit balances. headers: Cache-Control: description: Always `no-store`. schema: type: string content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/V2Account' metadata: $ref: '#/components/schemas/V2Metadata' required: - data - metadata example: data: object: account plan: pro credits: remaining: 12500 monthly_allowance: 10000 purchased: 2500 renews_at: '2026-11-01T00:00:00Z' can_buy_credits: true metadata: request_id: request_01k6z8m2a4b5c6d7e8f9g0h1j2 '401': $ref: '#/components/responses/V2Unauthorized' '403': description: >- The key is not attached to a Logo.dev account, the account is suspended, or personal keys are turned off because you belong to a team. The last two return a `msg` field, as an authentication error does. content: application/json: schema: oneOf: - $ref: '#/components/schemas/V2Error' - $ref: '#/components/schemas/V2AuthError' examples: no_account: value: error: code: forbidden message: >- this api key is not attached to a logo.dev account. check the key, or contact support@logo.dev docs_url: https://www.logo.dev/docs/platform/errors suspended: value: msg: >- account suspended. contact team@logo.dev for more information docs_url: https://www.logo.dev/docs/platform/errors '500': description: Reading the account failed. content: application/json: schema: $ref: '#/components/schemas/V2Error' example: error: code: internal message: failed to read account docs_url: https://www.logo.dev/docs/platform/errors security: - secretKey: [] components: schemas: V2Account: type: object properties: object: type: string const: account plan: type: string enum: - community - startup - scale - pro - enterprise - custom description: Your plan. `community` is the free plan. credits: type: object properties: remaining: type: integer description: >- Your total usable API credit balance: included plus purchased credits. monthly_allowance: type: integer description: API credits your plan includes each month. purchased: type: integer description: Purchased API credits you have not spent. renews_at: type: - string - 'null' format: date-time description: >- When your included credits next renew. `null` when your account is not yet set up for billing. can_buy_credits: type: boolean description: '`true` when your plan can buy more API credits.' required: - remaining - monthly_allowance - purchased - renews_at - can_buy_credits required: - object - plan - credits V2Metadata: type: object properties: request_id: type: string description: Unique id for this request. Also sent as the `Request-Id` header. examples: - request_01k6z8m2a4b5c6d7e8f9g0h1j2 resolution: allOf: - $ref: '#/components/schemas/V2Resolution' description: Brand and image lookups only. pending: allOf: - $ref: '#/components/schemas/V2Pending' description: '`202` responses only.' subscription: type: object description: >- Present when a brand lookup (`GET /v2/brands` or `GET /v2/brands/{id}`) ran the automatic subscribe: webhooks are on for the account, and `nosubscribe` is not `true`. See [automatic subscriptions](/brand/introduction#automatic-subscriptions). properties: status: type: string enum: - subscribed - quota_exceeded description: >- `subscribed`: the account is subscribed to the brand. `quota_exceeded`: the account is at its plan's subscription limit, so the brand was not subscribed. The lookup is answered and billed either way. message: type: string description: Why the subscribe was refused. Only with `quota_exceeded`. required: - status required: - request_id V2Error: type: object description: Error envelope for v2 routes. properties: error: type: object properties: code: type: string enum: - invalid_request - unauthorized - forbidden - resource_missing - insufficient_credits - rate_limited - limit_exceeded - internal message: type: string target: type: string description: The parameter at fault, when there is exactly one. required: - code - message docs_url: type: string format: uri description: Documentation for this class of error. required: - error V2AuthError: type: object description: >- Returned when the secret key is missing, malformed, unknown, or disabled, before the request reaches the v2 route. properties: msg: type: string docs_url: type: string format: uri required: - msg V2Resolution: type: object description: How the request identified the brand. properties: type: type: string enum: - domain - ticker - isin - crypto - name - brand_id description: Which identifier the request used. value: type: string description: >- The identifier after normalization: the registrable domain, an upper-cased ticker, and so on. method: type: string enum: - direct - domain - security - crypto - search - '' description: >- How the identifier reached the brand. `direct` is a brand id or a domain that is its own brand; `domain` went through an alias or redirect; `security` is a ticker or ISIN; `crypto` is a crypto token symbol; `search` is a name lookup. Empty on a cached miss. context: type: object description: >- Reserved for brands involved in a merchant lookup. Always `{}` today. required: - type - value - method - context V2Pending: type: object description: Present only on a `202`. Tells you when to retry. properties: reason: type: string enum: - indexing - resolving description: >- `indexing` is a brand's first crawl; `resolving` means the identifier is still being matched to a brand. message: type: string retry_after_seconds: type: integer description: Wait this long before retrying. Matches the `Retry-After` header. examples: - 30 expires_in_seconds: type: integer description: Stop polling after this long. examples: - 300 webhook: type: boolean description: >- Whether a `brand.indexed` webhook event carrying this request's `request_id` will be sent when the lookup settles. doc_url: type: string format: uri required: - reason - message - retry_after_seconds - expires_in_seconds - webhook - doc_url responses: V2Unauthorized: description: >- The secret key is missing, malformed, unknown, or disabled. A publishable key (`pk_`) is refused. content: application/json: schema: oneOf: - $ref: '#/components/schemas/V2AuthError' - $ref: '#/components/schemas/V2Error' example: msg: invalid api token. make sure to use your secret key. docs_url: https://www.logo.dev/docs/platform/api-keys securitySchemes: secretKey: type: http scheme: bearer description: >- Your secret key (`sk_`), as `Bearer sk_...`. Call the Logo.dev API only from your server. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.