API reference

REST API

Query the database from your own systems with the same filters as the search page. Available on the Team plan and above.

Base URL

https://artha-gii.vercel.app/api

Used in every example below

Auth

Authorization: Bearer …

Or the X-API-Key header

Format

application/json

UTF-8

GET/v1/organizations

Search organisations. Every search filter is a query parameter. Separate multiple values with commas.

Parameters

q: Free text across names, descriptions, domains and the people at the organisation
types: Investor type slugs, e.g. single-family-office,impact-fund
families: Investor family slugs, e.g. private-wealth,philanthropy
sectors: Sector slugs. Add sectors_mode=all to require every one
themes: Impact theme slugs
instruments: Instrument slugs
geos: Investment geography slugs (region, subregion or ISO-2 country)
countries: HQ country, ISO-3166-1 alpha-2
regions: HQ region label, e.g. Europe
ticket_min / ticket_max: Ticket size bounds in USD
aum_min / aum_max: AUM bounds in USD
has_verified_email: 1 to return only organisations with a verified contact
allocators_only: 1 to exclude advisors, networks and observers
freshness: fresh to return only organisations verified in the last 6 months
min_quality: Minimum completeness score, 0–100
sort: relevance · quality · contacts · aum · updated · name
limit / offset: Page size (max 100) and cursor

curl "https://artha-gii.vercel.app/api/v1/organizations?sectors=climate&types=single-family-office&ticket_min=1000000&has_verified_email=1&limit=25" \
  -H "Authorization: Bearer $GIID_KEY"

GET/v1/organizations/{slug}

One organisation, in the same shape as a search result.

curl https://artha-gii.vercel.app/api/v1/organizations/big-society-capital \
  -H "Authorization: Bearer $GIID_KEY"

GET/v1/organizations/{slug}/contacts

Named contacts. Email addresses are masked until your workspace reveals them. Pass reveal=true to reveal contacts from your remaining allowance.

Parameters

reveal: true to reveal as many contacts as the remaining allowance covers

curl "https://artha-gii.vercel.app/api/v1/organizations/big-society-capital/contacts?reveal=true" \
  -H "Authorization: Bearer $GIID_KEY"

POST/v1/match

Score investors against a raise. Each result includes a score and the reasons for it.

curl -X POST https://artha-gii.vercel.app/api/v1/match \
  -H "Authorization: Bearer $GIID_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sectors": ["agriculture-food", "climate"],
    "themes": ["smallholder-farmers"],
    "instruments": ["equity", "blended"],
    "geographies": ["eastern-africa"],
    "ticket_usd": 2000000,
    "limit": 25
  }'

GET/v1/coinvestors/{slug}

Investors similar to this one, ranked by shared sectors, themes, instruments, geographies and type.

curl https://artha-gii.vercel.app/api/v1/coinvestors/big-society-capital \
  -H "Authorization: Bearer $GIID_KEY"

GET/v1/taxonomy

All investor types, sectors, themes, instruments and geographies with their slugs. Cache it to keep your mapping in sync.

curl https://artha-gii.vercel.app/api/v1/taxonomy \
  -H "Authorization: Bearer $GIID_KEY"

Limits and errors

Quotas

Team: 10,000 calls per calendar month, 100 results per page.
Enterprise and Network: unlimited calls, negotiated concurrency.
Usage is counted per workspace, across all keys. Revoking a key does not reset it.
Contact reveals use the same allowance as the web app.

Error format

{
  "error": "quota_exceeded",
  "detail": "Monthly limit of 10000 calls reached."
}

401missing, malformed or revoked key
403plan does not include the API, or reveals are exhausted
404unknown slug
429monthly quota reached

Slugs you will need

The full list is at /v1/taxonomy. Some examples to start with:

Investor types

single-family-officemulti-family-officefamily-foundationfamily-trusthnwi-angelwealth-managerimpact-fundventure-capitalprivate-equityasset-manager

Sectors

agriculture-foodeducationhealthfinancial-inclusionenergyclimateenvironmentforestry-landoceanscircular-economy

Instruments

grantrecoverable-grantprize-challengetechnical-assistanceequitygrowth-equityseed-equityfund-investmentdebtworking-capital

The taxonomy page lists every value with a live count.