---
updatedAt: 2026-07-29T13:43:39.000Z
agentTools:
projectIndex: https://docs.beauhurst.com/llms.txt
---
# Get Fundraising and Grant data
Use a list of company IDs to return fundraising and grant details.
# OpenAPI definition
```json
{
"openapi": "3.0.3",
"info": {
"title": "Beauhurst API",
"version": "1.0.0 (beauhurstapi)",
"description": "Usage
The API only accepts GET requests over HTTPS.
Authorization
The Beauhurst API requires authentication in the form of an API key,provided in the format 'apikey '.
To obtain an API key, please contact your subscription's account manager at Beauhurst. Be sure to keep this key private and secure.
"
},
"paths": {
"/v1/transactions/company": {
"get": {
"operationId": "v1_transactions_company_list",
"description": "Use a list of company IDs to return fundraising and grant details.",
"summary": "Get Fundraising and Grant data",
"parameters": [
{
"in": "query",
"name": "company_ids",
"schema": {
"type": "array",
"items": {
"type": "string",
"maxLength": 8,
"minLength": 6
}
},
"description": "Beauhurst ID or Companies House ID for company",
"required": true
},
{
"in": "query",
"name": "date_raised__gte",
"schema": {
"type": "string",
"format": "date"
}
},
{
"in": "query",
"name": "date_raised__lte",
"schema": {
"type": "string",
"format": "date"
}
},
{
"in": "query",
"name": "includes",
"schema": {
"type": "array",
"items": {
"enum": [
"fundraisings",
"grants"
],
"type": "string",
"description": "* `fundraisings` - fundraisings\n* `grants` - grants"
}
},
"required": true
},
{
"name": "limit",
"required": false,
"in": "query",
"description": "Number of results to return per page.",
"schema": {
"type": "integer"
}
},
{
"name": "offset",
"required": false,
"in": "query",
"description": "The initial index from which to return the results.",
"schema": {
"type": "integer"
}
},
{
"name": "sort",
"required": false,
"in": "query",
"description": "Which field to use when ordering the results.",
"schema": {
"type": "string"
}
}
],
"tags": [
"v1"
],
"security": [
{
"tokenAuth": []
},
{
"tokenAuth": []
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PaginatedCompanyTransactionsList"
}
}
},
"description": ""
}
}
}
}
},
"components": {
"schemas": {
"CompanyTransactions": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string",
"readOnly": true,
"description": "(trading name)"
},
"companies_house_id": {
"type": "string"
},
"fundraisings": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Fundraising"
}
},
"grants": {
"type": "array",
"items": {
"$ref": "#/components/schemas/GrantParticipation"
}
}
},
"required": [
"companies_house_id",
"fundraisings",
"grants",
"id",
"name"
]
},
"Fundraising": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"date_raised": {
"type": "string",
"format": "date"
},
"amount_raised_gbp": {
"type": "integer"
},
"stage_of_evolution_at_date_raised": {
"type": "string"
},
"beauhurst_url": {
"type": "string",
"readOnly": true
},
"valuation_gbp": {
"type": "integer"
},
"valuation_confidence": {
"type": "string"
},
"is_announced": {
"type": "boolean"
},
"purposes_of_funding": {
"type": "array",
"items": {
"type": "string"
}
},
"types_of_funding": {
"type": "array",
"items": {
"type": "string"
}
},
"investor_names": {
"type": "array",
"items": {
"type": "string"
}
},
"investors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Investor"
}
},
"stake_taken_percentage": {
"type": "string",
"format": "decimal"
},
"event_status": {
"type": "string"
}
},
"required": [
"amount_raised_gbp",
"beauhurst_url",
"date_raised",
"event_status",
"id",
"investor_names",
"investors",
"is_announced",
"purposes_of_funding",
"stage_of_evolution_at_date_raised",
"stake_taken_percentage",
"types_of_funding",
"valuation_confidence",
"valuation_gbp"
]
},
"GrantParticipation": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"grant_project_id": {
"type": "string"
},
"iuk_project_number": {
"type": "string"
},
"date_grant_recieved": {
"type": "string",
"format": "date"
},
"amount_recieved_gbp": {
"type": "integer"
},
"amount_received": {
"type": "integer"
},
"stage_of_evolution_at_grant_date": {
"type": "string"
},
"beauhurst_url": {
"type": "string",
"readOnly": true
},
"is_lead_participant": {
"type": "boolean"
},
"project_title": {
"type": "string"
},
"project_start_date": {
"type": "string",
"format": "date"
},
"project_end_date": {
"type": "string",
"format": "date"
},
"project_grants_total_gbp": {
"type": "integer"
},
"granting_body": {
"type": "string"
},
"grant_funders": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Investor"
}
},
"event_status": {
"type": "string"
}
},
"required": [
"amount_received",
"amount_recieved_gbp",
"beauhurst_url",
"date_grant_recieved",
"event_status",
"grant_funders",
"grant_project_id",
"granting_body",
"id",
"is_lead_participant",
"project_end_date",
"project_grants_total_gbp",
"project_start_date",
"project_title",
"stage_of_evolution_at_grant_date"
]
},
"Investor": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"fund_type": {
"type": "string",
"nullable": true
}
},
"required": [
"fund_type",
"id",
"name"
]
},
"PaginatedCompanyTransactionsList": {
"type": "object",
"properties": {
"meta": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"example": 10
},
"limit": {
"type": "integer",
"example": 10
},
"offset": {
"type": "integer",
"example": 10
},
"count": {
"type": "integer",
"example": 10
}
}
},
"results": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CompanyTransactions"
}
}
}
}
},
"securitySchemes": {
"tokenAuth": {
"type": "apiKey",
"in": "header",
"name": "Authorization",
"description": "Token-based authentication with required prefix \"APIkey\""
}
}
},
"servers": [
{
"url": "https://platform.beauhurst.com/_api"
}
],
"x-readme": {}
}
```