{
  "openapi": "3.0.1",
  "info": {
    "title": "Charity Commission Register Search (England & Wales)",
    "description": "Search all 170k+ registered charities in England and Wales by name, postcode area, income, cause, beneficiaries, area of operation or registration date. Contact details, finances and classifications from the official daily register extract. No API key needed.",
    "version": "1.0",
    "x-build-id": "anqgkJhcmHkkF8ura"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/onibaku~uk-charity-register/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-onibaku-uk-charity-register",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/onibaku~uk-charity-register/runs": {
      "post": {
        "operationId": "runs-sync-onibaku-uk-charity-register",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/onibaku~uk-charity-register/run-sync": {
      "post": {
        "operationId": "run-sync-onibaku-uk-charity-register",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "nameContains": {
            "title": "Name contains",
            "type": "string",
            "description": "Part of the charity name, e.g. \"food bank\" or \"scouts\"."
          },
          "charityNumbers": {
            "title": "Charity numbers",
            "type": "array",
            "description": "Look up specific registered charity numbers, e.g. 1089464.",
            "items": {
              "type": "string"
            }
          },
          "postcodePrefixes": {
            "title": "Postcode areas or districts",
            "type": "array",
            "description": "Contact postcode starts with, e.g. \"LS\" (all of Leeds), \"M1\" or \"SW1A\".",
            "items": {
              "type": "string"
            }
          },
          "areasOfOperation": {
            "title": "Area of operation contains",
            "type": "array",
            "description": "Where the charity says it works, e.g. \"Leeds City\", \"Wales\" or \"Kenya\".",
            "items": {
              "type": "string"
            }
          },
          "causes": {
            "title": "Causes (what)",
            "type": "array",
            "description": "Match any of these charitable purposes.",
            "items": {
              "type": "string",
              "enum": [
                "General charitable purposes",
                "Education/training",
                "Health or saving of lives",
                "Disability",
                "Prevention or relief of poverty",
                "Overseas aid/famine relief",
                "Accommodation/housing",
                "Religious activities",
                "Arts/culture/heritage/science",
                "Amateur sport",
                "Animals",
                "Environment/conservation/heritage",
                "Economic/community development/employment",
                "Armed forces/emergency service efficiency",
                "Human rights/religious or racial harmony/equality or diversity",
                "Recreation",
                "Other charitable purposes"
              ]
            }
          },
          "beneficiaries": {
            "title": "Beneficiaries (who)",
            "type": "array",
            "description": "Match any of these groups.",
            "items": {
              "type": "string",
              "enum": [
                "Children/young people",
                "Elderly/old people",
                "People with disabilities",
                "People of a particular ethnic or racial origin",
                "Other charities or voluntary bodies",
                "Other defined groups",
                "The general public/mankind"
              ]
            }
          },
          "activities": {
            "title": "How it helps",
            "type": "array",
            "description": "Match any of these, e.g. \"Makes grants to organisations\" to find grant-makers.",
            "items": {
              "type": "string",
              "enum": [
                "Makes grants to individuals",
                "Makes grants to organisations",
                "Provides other finance",
                "Provides human resources",
                "Provides buildings/facilities/open space",
                "Provides services",
                "Provides advocacy/advice/information",
                "Sponsors or undertakes research",
                "Acts as an umbrella or resource body",
                "Other charitable activities"
              ]
            }
          },
          "activitiesContain": {
            "title": "Activities text contains",
            "type": "string",
            "description": "Searches the charity's own description of its activities."
          },
          "status": {
            "title": "Registration status",
            "enum": [
              "registered",
              "removed",
              "all"
            ],
            "type": "string",
            "description": "Registered (default), removed from the register, or both.",
            "default": "registered"
          },
          "minIncome": {
            "title": "Minimum latest income (£)",
            "minimum": 0,
            "type": "integer",
            "description": "From the latest annual return."
          },
          "maxIncome": {
            "title": "Maximum latest income (£)",
            "minimum": 0,
            "type": "integer",
            "description": "From the latest annual return."
          },
          "registeredFrom": {
            "title": "Registered on or after",
            "type": "string",
            "description": "Find newly registered charities (YYYY-MM-DD)."
          },
          "registeredTo": {
            "title": "Registered on or before",
            "type": "string",
            "description": "Registered on or before this date (YYYY-MM-DD)."
          },
          "removedFrom": {
            "title": "Removed on or after",
            "type": "string",
            "description": "With status Removed or All: charities removed from the register since this date."
          },
          "cioOnly": {
            "title": "CIOs only",
            "type": "boolean",
            "description": "Only Charitable Incorporated Organisations.",
            "default": false
          },
          "withContactDetailsOnly": {
            "title": "Only charities with an email, phone or website",
            "type": "boolean",
            "description": "Only charities that publish an email, phone number or website.",
            "default": false
          },
          "includeLinkedCharities": {
            "title": "Include linked (subsidiary) charities",
            "type": "boolean",
            "description": "Linked (subsidiary) charities are left out by default.",
            "default": false
          },
          "includeClassifications": {
            "title": "Add causes, beneficiaries and areas to each row",
            "type": "boolean",
            "description": "Adds four list columns. Takes about a minute longer.",
            "default": false
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "charityNumber",
              "incomeDesc",
              "registeredDesc"
            ],
            "type": "string",
            "description": "Order of the results.",
            "default": "charityNumber"
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 500000,
            "type": "integer",
            "description": "Stop after this many results.",
            "default": 1000
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}