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

# List charity request registers

> Countries and official registers that charities can be searched and requested from, with the registration format each accepts. A register entry identifies an organisation; it does not confirm tax deductibility or endorsement.



## OpenAPI

````yaml https://api.donate.gg/api/openapi get /v1/charity-requests/registers
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 later `/v2`).
    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:
  /v1/charity-requests/registers:
    get:
      summary: List charity request registers
      description: >-
        Countries and official registers that charities can be searched and
        requested from, with the registration format each accepts. A register
        entry identifies an organisation; it does not confirm tax deductibility
        or endorsement.
      operationId: v1.charityRequests.registers
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          enum:
                            - united-states
                            - england-wales
                            - scotland
                            - northern-ireland
                            - france
                            - japan
                            - new-zealand
                            - norway
                            - netherlands
                            - canada
                            - australia
                          type: string
                          description: Register id from GET /charity-requests/registers
                        country:
                          enum:
                            - US
                            - UK
                            - FR
                            - JP
                            - NZ
                            - 'NO'
                            - NL
                            - CA
                            - AU
                          type: string
                        name:
                          type: string
                        source:
                          type: object
                          properties:
                            name:
                              type: string
                            url:
                              type: string
                          required:
                            - name
                            - url
                          additionalProperties: false
                        attribution:
                          type: object
                          properties:
                            text:
                              type: string
                            url:
                              anyOf:
                                - type: string
                                - type: 'null'
                          required:
                            - text
                            - url
                          additionalProperties: false
                          description: >-
                            Attribution to show wherever data from this register
                            is displayed
                        registration:
                          type: object
                          properties:
                            label:
                              type: string
                            example:
                              type: string
                            pattern:
                              type: string
                              description: >-
                                Unanchored regular expression for accepted
                                registration input
                          required:
                            - label
                            - example
                            - pattern
                          additionalProperties: false
                        refresh:
                          enum:
                            - live
                            - daily
                          type: string
                          description: >-
                            `live` reads the register per request; `daily` uses
                            a snapshot refreshed daily
                        coverage:
                          type: string
                      required:
                        - id
                        - country
                        - name
                        - source
                        - attribution
                        - registration
                        - refresh
                        - coverage
                      additionalProperties: false
                required:
                  - items
                additionalProperties: false
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.