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

# Get a donating token and its configs



## OpenAPI

````yaml https://api.donate.gg/api/openapi get /v2/{chainId}/tokens/{address}
openapi: 3.1.1
info:
  title: Donate Developer API
  version: 1.0.0
  description: >-
    Public JSON API for charities, configs, campaigns, tokens, and related
    catalog reads. Operations are grouped by version (`/v1` and `/v2`). V2
    supports named charity and campaign beneficiaries; v1 preserves user/charity
    config shapes. GET/HEAD catalog routes may omit `donate-api-key` and are IP
    rate-limited for anonymous callers (~20 req/min). Authenticated keys share
    one organization rate-tier bucket. Create/list configs and project analytics
    require an API key. Configs are permanent; the retained authenticated DELETE
    endpoint rejects deletion. Unpublished internal routes are omitted. Spec
    routes (`/api/openapi`, `/api/postman`) are unauthenticated and unmetered.
servers:
  - url: /api
    description: API origin. Version prefixes live on each operation path.
security:
  - {}
  - ApiKeyAuth: []
paths:
  /v2/{chainId}/tokens/{address}:
    get:
      summary: Get a donating token and its configs
      operationId: v2.coins.getToken
      parameters:
        - name: chainId
          in: path
          required: true
          schema:
            type: number
            description: Chain ID
        - name: address
          in: path
          required: true
          schema:
            type: string
            description: Chain address
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  moderation:
                    anyOf:
                      - type: object
                        properties:
                          hidden:
                            type: boolean
                          hiddenReasons:
                            type: array
                            items:
                              enum:
                                - INAPPROPRIATE_NAME
                                - INAPPROPRIATE_IMAGE
                                - OTHER
                              type: string
                          moderationSource:
                            anyOf:
                              - enum:
                                  - AI
                                  - ADMIN
                                type: string
                              - type: 'null'
                        required:
                          - hidden
                          - hiddenReasons
                          - moderationSource
                        additionalProperties: false
                      - type: 'null'
                  chain:
                    type: object
                    properties:
                      id:
                        type: number
                      name:
                        type: string
                      type:
                        enum:
                          - bitcoin
                          - evm
                          - solana
                        type: string
                    required:
                      - id
                      - name
                      - type
                    additionalProperties: false
                  token:
                    type: object
                    properties:
                      address:
                        type: string
                      name:
                        type: string
                      symbol:
                        type: string
                      decimals:
                        type: number
                    required:
                      - address
                      - name
                      - symbol
                      - decimals
                    additionalProperties: false
                  activeConfig:
                    type: object
                    properties:
                      id:
                        type: object
                        properties:
                          hex:
                            type: string
                          base58:
                            type: string
                        required:
                          - hex
                          - base58
                        additionalProperties: false
                      feeBps:
                        type: string
                        description: >-
                          Stored config fee. Use the effective-fee endpoint for
                          current pricing.
                      beneficiaries:
                        type: array
                        items:
                          anyOf:
                            - type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                logo:
                                  type: string
                                  description: >-
                                    Public image URL, or the Donate placeholder
                                    when no image is available.
                                type:
                                  const: charity
                                weight:
                                  type: string
                              required:
                                - id
                                - name
                                - logo
                                - type
                                - weight
                              additionalProperties: false
                            - type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                logo:
                                  type: string
                                  description: >-
                                    Public image URL, or the Donate placeholder
                                    when no image is available.
                                type:
                                  const: campaign
                                source:
                                  enum:
                                    - donate
                                    - tiltify
                                  type: string
                                weight:
                                  type: string
                              required:
                                - id
                                - name
                                - logo
                                - type
                                - source
                                - weight
                              additionalProperties: false
                    required:
                      - id
                      - feeBps
                      - beneficiaries
                    additionalProperties: false
                  previousConfigs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: object
                          properties:
                            hex:
                              type: string
                            base58:
                              type: string
                          required:
                            - hex
                            - base58
                          additionalProperties: false
                        feeBps:
                          type: string
                          description: >-
                            Stored config fee. Use the effective-fee endpoint
                            for current pricing.
                        beneficiaries:
                          type: array
                          items:
                            anyOf:
                              - type: object
                                properties:
                                  id:
                                    type: string
                                  name:
                                    type: string
                                  logo:
                                    type: string
                                    description: >-
                                      Public image URL, or the Donate
                                      placeholder when no image is available.
                                  type:
                                    const: charity
                                  weight:
                                    type: string
                                required:
                                  - id
                                  - name
                                  - logo
                                  - type
                                  - weight
                                additionalProperties: false
                              - type: object
                                properties:
                                  id:
                                    type: string
                                  name:
                                    type: string
                                  logo:
                                    type: string
                                    description: >-
                                      Public image URL, or the Donate
                                      placeholder when no image is available.
                                  type:
                                    const: campaign
                                  source:
                                    enum:
                                      - donate
                                      - tiltify
                                    type: string
                                  weight:
                                    type: string
                                required:
                                  - id
                                  - name
                                  - logo
                                  - type
                                  - source
                                  - weight
                                additionalProperties: false
                      required:
                        - id
                        - feeBps
                        - beneficiaries
                      additionalProperties: false
                  creatorAddress:
                    type: string
                required:
                  - moderation
                  - chain
                  - token
                  - activeConfig
                  - previousConfigs
                  - creatorAddress
                additionalProperties: false
        '400':
          description: '400'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: VALIDATION_ERROR
                      status:
                        const: 400
                      message:
                        type: string
                        default: Validation failed
                      data:
                        type: object
                        properties:
                          error:
                            type: string
                          code:
                            const: VALIDATION_ERROR
                          issues:
                            type: array
                            items:
                              anyOf:
                                - {}
                                - type: 'null'
                        required:
                          - error
                          - code
                        additionalProperties: false
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '404':
          description: '404'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: NOT_FOUND
                      status:
                        const: 404
                      message:
                        type: string
                        default: Not found
                      data:
                        type: object
                        properties:
                          error:
                            type: string
                          code:
                            const: NOT_FOUND
                        required:
                          - error
                          - code
                        additionalProperties: false
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '409':
          description: '409'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: CONFIG_NOT_SUPPORTED
                      status:
                        const: 409
                      message:
                        type: string
                        default: >-
                          This config contains direct user beneficiaries. Use
                          API v1 to inspect it.
                      data:
                        type: object
                        properties:
                          error:
                            type: string
                          code:
                            const: CONFIG_NOT_SUPPORTED
                        required:
                          - error
                          - code
                        additionalProperties: false
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '503':
          description: '503'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: PROVIDER_UNAVAILABLE
                      status:
                        const: 503
                      message:
                        type: string
                        default: Provider temporarily unavailable
                      data:
                        type: object
                        properties:
                          error:
                            type: string
                          code:
                            const: PROVIDER_UNAVAILABLE
                        required:
                          - error
                          - code
                        additionalProperties: false
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: donate-api-key
      description: >-
        Developer API key. Required for config create/list and project
        analytics. The disabled config DELETE endpoint also requires
        authentication. Optional on public GET reads (anonymous callers are IP
        rate-limited). Obtain from the Developer dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.