Skip to main content
POST
Find by details

Authorizations

X-API-KEY
string
header
required

Body

application/json

Request body for finding organizations. Each field is optional. However, you must provide at least one field to perform a valid search. The values a filter accepts can be listed with GET /v1/knowledge-graph/organizations/values/{filter}.

query
string

Text query to search for organizations by name or description. Examples: 'Federal Reserve', 'European Commission'

Example:

"Federal Reserve"

types
string[]

Organization types, as published in the type field of results (e.g., 'Central Bank', 'Bank', 'Council')

Example:
countries
string[]

Country codes using the ISO 3166-1 A-2 format (e.g., 'US' for United States, 'FR' for France, 'GB' for Great Britain)

Pattern: ^[A-Z]{2}$
Example:
owners
string[]

Names of the owning organization, as published in the owner field of results

Example:

Response

200 - application/json

Successful response with organizations data

Response containing organizations results and metadata

results
object[]
required

Array of organizations results

metadata
object
required
usage
object

Optional. Present for token-billing accounts only. Reports the number of tokens consumed by this request.