Référence de l'API

Référence de l'API de données Tera

Une API REST en lecture seule sur les actifs du réseau électrique, les entreprises du marché de l'électricité et les personnes qui y travaillent. Chaque fiche a un identifiant stable et indique les sources dont elle provient.

À quoi sert l'API

Tera est une plateforme d'intelligence de marché pour le secteur de l'électricité. Les équipes de développement commercial, d'investissement et d'études s'en servent pour savoir qui détient, construit et exploite les centrales et les ouvrages du réseau, quelles sociétés sont actives sur un marché et à qui s'adresser chez elles. L'API met ces mêmes données dans vos propres systèmes : un CRM qui connaît chaque développeur de votre région, un modèle alimenté par les centrales qui correspondent à votre mandat, un outil interne qui signale un projet le jour où il change de propriétaire.

Les usages courants et les appels qui y répondent
Ce que votre équipe veut faireAppels
Dresser la liste des projets ou des centrales à cibler
Cartographier les sociétés actives sur un marché
Trouver le bon interlocuteur dans une société
Vérifier une contrepartie avant une opération
Mesurer un marché pour une présentation ou une étude
Rapprocher les comptes de votre CRM des sociétés de Tera
Renseigner les actifs d'une entreprise, avec son rôle et sa part dans chacun
Suivre des sociétés et des projets : savoir quand un propriétaire, un statut ou une phase change

URL de base

Chaque appel s'adresse à /v1 sur la plateforme de données Tera, à l'adresse ci-dessous. Les réponses sont en JSON, uniquement en HTTPS.

https://data.teraintel.com/v1

Authentification

Envoyez votre clé d'API comme jeton porteur dans l'en-tête Authorization. Ne la placez jamais dans l'URL : l'API rejette la requête dans ce cas. Une entreprise vérifiée obtient une clé en quelques minutes, avec 5 000 crédits gratuits par mois.

Authorization: Bearer $TERA_API_KEY

Crédits par appel

Chaque appel consomme des crédits de votre allocation, et le bloc meta de la réponse indique son coût. Un appel qui liste des fiches ajoute 100 crédits par tranche de 25 lignes supplémentaires. Vérifier une clé, la taille du jeu de données, les vocabulaires ou la couverture d'un champ est gratuit. Une clé prépayée paie 200 crédits par personne, dans une recherche comme en fiche complète.

Coût en crédits de chaque appel
AppelCrédits
GET/v1/assets200
GET/v1/organizations200
GET/v1/organizations/{id}/assets200
POST/v1/match50
GET/v1/people500
GET/v1/entity500100 pour une borne de recharge, 800 pour un poste avec capacité d'accueil
GET/v1/changes200
GET/v1/watchlistsGratuit
GET/v1/watchlists/{name}Gratuit
PUT/v1/watchlists/{name}Gratuit
DELETE/v1/watchlists/{name}Gratuit
GET/v1/filtersGratuit
GET/v1/meGratuit
GET/v1/statsGratuit
GET/v1/aggregate300
GET/v1/coverageGratuit
POST/v1/people/{id}/email500

Réponses et erreurs

Un appel réussi renvoie data, les fiches ou le résultat, et meta, qui porte la pagination et la mesure de consommation. Une erreur renvoie ok à false et un message d'erreur. Le code de statut indique la suite à donner.

Statuts d'erreur
StatutSignification
400La requête est mal formée ou une valeur de filtre n'est pas acceptée. Le message d'erreur précise laquelle.
401Aucune clé n'a été envoyée, ou la clé n'est pas valide.
402L'allocation de crédits de la période est épuisée.
403La clé n'a pas le droit d'accès requis par l'appel, ou le compte n'est pas actif.
404Cet identifiant n'a jamais été émis par l'API.
429Trop de requêtes. L'en-tête Retry-After indique le délai d'attente.
Champs de meta
meta.countintegerNumber of records in this page.
meta.credits_chargedintegerCredits this call cost.
meta.credits_usedintegerCredits used this billing period.
meta.credits_includedintegerCredits included in the plan this period.
meta.credits_remainingintegerCredits left for the month (prepaid keys: allowance plus balance).
meta.has_morebooleanWhether another page follows.
meta.limitintegerPage size applied to this response.
meta.offsetintegerRecords skipped before this page.
okbooleanAlways false on an error.
errorstringWhy the request was refused.

À propos des données

Read access to Tera's curated dataset.

Identity. Every record carries an opaque id (ast_, org_, per_ prefixed) that is stable across our rebuilds. Store that id, never a name or a URL. If two records are later found to be the same entity they are merged: the id you hold keeps working forever and tells you where it went, so a stored reference never dangles.

Provenance. Records carry the sources behind them. An answer you cannot trace is an answer you should not act on, and every record here can be traced.

Vocabularies are live. Do not hard-code the values a filter accepts. GET /v1/filters returns the current grammar and the real values, free of charge.

A gap in our data is not a gap in the market. Coverage differs from one slice of the market to the next. An empty result means we hold nothing for that query, not that nothing exists; /v1/coverage says how often we hold a field for the slice you are about to quote.

Credits and licences. A prepaid key buys look-ups: a list row finds a record (its operator, estimates, grid capacity and sources come with the full record from /v1/entity), and the change feed, contact details and a person's LinkedIn page are part of a licence. A licence key reads the full row.

Points d'accès

GET/v1/assets#

Filtered list of power grid assets

Crédits par appel 200, plus 100 par tranche de 25 lignes supplémentaires

What it is for. Building a list of the power plants, substations, EV charging sites and data centres your team targets. A developer sees what is being built in its region, an investor or acquirer finds plants that fit its mandate, an EPC or a manufacturer finds projects heading for construction, an O&M provider finds ageing fleets. Each record names who owns and operates the asset, so a list of assets is also a list of companies to approach. It returns what the Assets list in Tera shows for the same filters.

On a prepaid key a row finds a record: operator, estimates, grid_capacity and sources come with the full record from /v1/entity, at the record's rate, and meta.withheld names them. A licence key reads the full row. Filtering on a value reads it, so a prepaid key may not set grid_available_min or grid_free_bay (it may use has_grid_capacity, grid_direction and grid_technology), and a key that has not topped up may not set est_valuation_min or est_valuation_max; either answers 403. The same holds on /v1/aggregate and /v1/coverage.

Filters accept the values GET /v1/filters reports. Ordering is fixed and deterministic so paging cannot skip or repeat a record.

Paramètres
qfacultatifstringFree-text search. Distinctive words must match; generic industry words (plant, power, solar, farm, ltd) only affect ranking, so "solar farm cork" returns Cork assets rather than nothing. Accent- and case-insensitive, tolerant of typos, and unit numbers are equivalent ("hornsea two" finds "Hornsea 2"). Acronyms resolve on organizations and employers. Results come back in relevance order, which is the same engine and the same ranking the Tera app itself searches with. A query containing nothing distinctive ("solar", "power plant" - only generic industry words) is refused with 400: it matches tens of thousands of records and ranks them all alike, so there is no useful answer to give. Ask those as filters instead (energy_source=solar, kind=power_plant), which is both exact and fast.
limitfacultatifinteger (1..)Page size, capped by your plan. See /v1/me.
offsetfacultatifinteger (0..10000)Capped at 10000. When q is set the cap is 3000 minus your page size, because a relevance search ranks a bounded window and there is no defined order beyond it. Narrow with filters, or use /v1/changes to keep an existing set in sync.
kindfacultatifstringAsset kind: power_plant, substation, charging_station or datacenter. Valeurs: power_plantsubstationcharging_stationdatacenter
typefacultatifstringLifecycle status.
countryfacultatifstringCountry, by the full name that /v1/filters lists (for example Spain).
energy_classfacultatifstringBroad energy grouping, such as renewable or fossil. Values: /v1/filters.
energy_sourcefacultatifstringEnergy source, such as solar, wind or natural_gas. Values: /v1/filters.
generation_techfacultatifstringGeneration technology, such as pv, onshore or ccgt. Values: /v1/filters.
operatorfacultatifstringExact match on the operator name shown on the record.
capacity_minfacultatifintegerNameplate capacity, kW.
capacity_maxfacultatifintegerNameplate capacity, kW.
voltage_minfacultatifintegerkV.
voltage_maxfacultatifintegerkV.
year_minfacultatifintegerRecords with no commissioning year are always included.
year_maxfacultatifintegerLatest commissioning year. Records with no commissioning year are always included.
price_minfacultatifnumberUSD. Converted before comparison; records we cannot convert drop out.
price_maxfacultatifnumberHighest reported price, USD. Converted before comparison; records we cannot convert drop out.
addressfacultatifstringFree text matched against the street address, locality and postcode.
bboxfacultatifstringmin_lon,min_lat,max_lon,max_lat in WGS84. Rows with no coordinates never match. Prefer near/radius_km unless you genuinely have a rectangle.
nearfacultatifstringCentre point as lat,lon - for example near=53.35,-6.26. Requires radius_km, and the two are rejected unless sent together: a default radius would silently answer a different question. True great-circle distance, not a bounding square. Rows with no coordinates never match.
radius_kmfacultatifnumber (0..<501)Radius in km around near, up to 500. Beyond that the search area stops narrowing anything useful - ask it as country= or bbox= instead.
has_picturefacultatifstringSend 1 to keep only assets that have a picture. Valeurs: 1
has_namefacultatifstringSend 1 to keep only assets that have a name. Valeurs: 1
has_capacityfacultatifstringSend 1 to keep only assets with a nameplate capacity on file. Valeurs: 1
has_voltagefacultatifstringSend 1 to keep only assets with a voltage on file. Valeurs: 1
has_grid_capacityfacultatifstringSubstations with published grid-access capacity (Spain, Portugal, France, Ireland). Valeurs: 1
grid_directionfacultatifstringGrid capacity for connecting generation (default), demand or storage. Any grid_* parameter restricts to substations with a published figure for the question and orders results by it, largest first. Valeurs: generationdemandstorage
grid_technologyfacultatifstringWhat would connect: any (default), power_park, synchronous, or a word such as solar, wind, battery, gas, hydro. Decides which Spanish transmission figure applies.
grid_available_minfacultatifnumber (0..)Least capacity a SINGLE connection point must offer, in the publisher's unit (MW; MVA in Portugal and for Irish demand).
grid_free_bayfacultatifstringDrop connection points that publish zero free bays. Valeurs: 1

Exemple

curl "https://data.teraintel.com/v1/assets?country=Spain&energy_source=solar&limit=5" \
  -H "Authorization: Bearer $TERA_API_KEY"
Champs de chaque fiche dans data
idstringTera's stable id (ast_, org_, per_). Survives rebuilds and merges.
kindstringAsset kind: power_plant, substation, charging_station or datacenter. Valeurs: power_plantsubstationcharging_stationdatacenter
namestringThe name as Tera records it.
statusstringLifecycle status: operating, planned, under_construction, announced, cancelled, retired, mothballed. On the Free plan a project not yet built reads in_development, with no commissioning year.
nameplate_capacityobjectNameplate (rated) capacity, as stored - kW. Not grid capacity, which is grid_capacity.
nameplate_capacity.valueintegerRated output, in the unit beside it.
nameplate_capacity.unitstringUnit of the value: kW unless the record states another.
grid_capacityobjectGrid-access capacity of a substation, present when the publisher of its network releases it: the room left for generation, storage and demand. Null otherwise.
grid_capacity.generationobjectBest connection point for generation: the room it can still take, in the unit stated, with the voltage, the queued request and the free bays.
grid_capacity.generation.availablenumberCapacity the point can still take, for any technology.
grid_capacity.generation.unitstringMW or MVA, as published. MVA is apparent power: real power is at most the MVA figure.
grid_capacity.generation.voltage_kvnumberVoltage of that connection point, kV.
grid_capacity.generation.queuednumberCapacity requested and not yet resolved; it competes for the same room.
grid_capacity.generation.bays_freeintegerFree connection bays (Spain, transmission). 0 means a new connection needs new bays, whatever the MW.
grid_capacity.generation_technologystringWhich technology the generation figure answers: power_park or synchronous. Valeurs: power_parksynchronous
grid_capacity.storageobjectBest connection point for storage: the room it can still take, in the unit stated, with the voltage, the queued request and the free bays.
grid_capacity.storage.availablenumberCapacity the point can still take, for any technology.
grid_capacity.storage.unitstringMW or MVA, as published. MVA is apparent power: real power is at most the MVA figure.
grid_capacity.storage.voltage_kvnumberVoltage of that connection point, kV.
grid_capacity.storage.queuednumberCapacity requested and not yet resolved; it competes for the same room.
grid_capacity.storage.bays_freeintegerFree connection bays (Spain, transmission). 0 means a new connection needs new bays, whatever the MW.
grid_capacity.demandobjectBest connection point for demand: the room it can still take, in the unit stated, with the voltage, the queued request and the free bays.
grid_capacity.demand.availablenumberCapacity the point can still take, for any technology.
grid_capacity.demand.unitstringMW or MVA, as published. MVA is apparent power: real power is at most the MVA figure.
grid_capacity.demand.voltage_kvnumberVoltage of that connection point, kV.
grid_capacity.demand.queuednumberCapacity requested and not yet resolved; it competes for the same room.
grid_capacity.demand.bays_freeintegerFree connection bays (Spain, transmission). 0 means a new connection needs new bays, whatever the MW.
grid_capacity.sourcestringThe publisher of the figures behind this summary.
grid_capacity.vintagestringThe publisher's edition the figures come from (e.g. 2026-08, 2026-Q2).
annual_productionobjectEnergy produced in a year (MWh).
annual_production.valuenumberEnergy produced in a year.
annual_production.unitstringAlways MWh.
voltage_kvintegerVoltage in kV (of the asset, or of a connection point).
charging_pointsintegerEV charging: vehicles that can charge at once. Not a power figure.
commissioning_yearintegerYear the asset entered service.
energyobjectThe asset's energy class, energy sources and generation technology.
energy.classstringBroad energy grouping, e.g. renewable or fossil.
energy.sourcesarray of stringThe energy sources the asset uses, such as solar, wind or natural_gas.
energy.generation_techstringGeneration technology, e.g. pv, onshore, ccgt.
locationobjectWhere the asset is: country, locality, address and coordinates.
location.countrystringCountry, by its full name.
location.country_codestringISO 3166-1 alpha-2 country code.
location.localitystringTown or city.
location.postcodestringPostal code.
location.addressstringStreet address.
location.latitudenumberWGS84 latitude.
location.longitudenumberWGS84 longitude.
location.precisionstringsite = the coordinate is the asset. area = it is the area the asset sits in. Absent means we will not claim either, which matters if you are siting anything off these numbers. Valeurs: sitearea
operatorstringThe company the record names as operating the asset.
plant_groupstringPresent when this record is one phase of a larger plant.
completenessnumber0 to 1. How much of the record we hold, not a confidence score.
sourcesarray of stringWho the values on this record came from, most-contributing first. Usually a dataset, named as its publisher names it; where we read a value off a published page it is the PUBLISHER of that page - the company whose site described the project, or the body that issued the document - never the name of our own reading process.
updated_atstringWhen the SOURCE last changed, not when our pipeline last ran.
urlstringThe record's page in Tera, for a person to check or share.
  • 200A page of assets.
  • 402Credit allowance for the period is spent.
  • 429Rate limited. Retry-After is set.

GET/v1/organizations#

Filtered list of electricity-market organizations

Crédits par appel 200, plus 100 par tranche de 25 lignes supplémentaires

What it is for. Finding the companies active in a market: the developers, utilities, IPPs, EPCs, manufacturers, investors and lenders in a country or a technology. Use it to map competitors, shortlist partners or build a list of prospective clients, then open each company with /v1/entity for its assets, its owners and its people. It returns what the Organizations list in Tera shows. On a prepaid key a row leaves its sources to the full record, and meta.withheld says so.

Paramètres
qfacultatifstringFree-text search. Distinctive words must match; generic industry words (plant, power, solar, farm, ltd) only affect ranking, so "solar farm cork" returns Cork assets rather than nothing. Accent- and case-insensitive, tolerant of typos, and unit numbers are equivalent ("hornsea two" finds "Hornsea 2"). Acronyms resolve on organizations and employers. Results come back in relevance order, which is the same engine and the same ranking the Tera app itself searches with. A query containing nothing distinctive ("solar", "power plant" - only generic industry words) is refused with 400: it matches tens of thousands of records and ranks them all alike, so there is no useful answer to give. Ask those as filters instead (energy_source=solar, kind=power_plant), which is both exact and fast.
limitfacultatifinteger (1..)Page size, capped by your plan. See /v1/me.
offsetfacultatifinteger (0..10000)Capped at 10000. When q is set the cap is 3000 minus your page size, because a relevance search ranks a bounded window and there is no defined order beyond it. Narrow with filters, or use /v1/changes to keep an existing set in sync.
countryfacultatifstringCountry, by the full name that /v1/filters lists (for example Spain).
typefacultatifstringCompany role in the market, such as utility, ipp, developer, investor, epc or manufacturer. Values: /v1/filters.
energy_classfacultatifstringBroad energy grouping, such as renewable or fossil. Values: /v1/filters.
energy_sourcefacultatifstringEnergy source, such as solar, wind or natural_gas. Values: /v1/filters.
generation_techfacultatifstringGeneration technology, such as pv, onshore or ccgt. Values: /v1/filters.
has_assetsfacultatifstringSend 1 to keep only companies linked to at least one asset. Valeurs: 1
has_peoplefacultatifstringSend 1 to keep only companies we hold at least one person for. Valeurs: 1
has_ownershipfacultatifstringSend 1 to keep only companies with a recorded owner or shareholding. Valeurs: 1

Exemple

curl "https://data.teraintel.com/v1/organizations?country=Spain&type=utility&limit=5" \
  -H "Authorization: Bearer $TERA_API_KEY"
Champs de chaque fiche dans data
idstringTera's stable id (ast_, org_, per_). Survives rebuilds and merges.
namestringThe name as Tera records it.
typesarray of stringCompany roles in the market: ipp, utility, investor, developer, epc, manufacturer, ...
locationobjectWhere the company is based: country, locality and the address as a registry states it.
home_pagestringThe company's website.
linkedin_urlstringLinkedIn page.
founded_yearintegerYear founded.
employeesintegerNumber of employees.
financialsobjectRevenue, assets under management and their currency, where we hold them.
energyobjectThe energy classes, sources and technologies of the company's assets.
assetsobjectCounts roll up the ownership subtree where we hold one, which is the figure the Tera app shows for the same company.
assets.countintegerNumber of assets linked to the company.
assets.by_statusobjectThe company's assets counted by lifecycle status (operating, planned, under_construction and so on).
owned_byarray of objectCompanies holding a share of this one.
ownsarray of objectCompanies this one holds a share of.
sourcesarray of stringWho the values on this record came from, most-contributing first. Usually a dataset, named as its publisher names it; where we read a value off a published page it is the PUBLISHER of that page - the company whose site described the project, or the body that issued the document - never the name of our own reading process.
updated_atstringWhen a source last changed this record.
urlstringThe record's page in Tera, for a person to check or share.
  • 200A page of organizations.

GET/v1/organizations/{id}/assets#

A company's assets

Crédits par appel 200, plus 100 par tranche de 25 lignes supplémentaires

What it is for. Reading one company's portfolio: the plants, substations and sites it owns, operates, develops or services today, each with its role, its share and since when. A CRM or a credit file fills a company's assets from its id, after /v1/match or /v1/organizations gave it.

Direct links only, as the company's Assets tab in Tera: a subsidiary's assets are on the subsidiary's id (/v1/entity lists a company's subsidiaries), and a link that ended stays on the asset's record. Filter by role and by the asset filters of /v1/assets; ordered by nameplate capacity, largest first. A row is the /v1/assets row, a finder on a prepaid key, and the same filters are refused there. Priced as /v1/assets.

Paramètres
idobligatoirestringA company id from this API (org_...), from /v1/organizations, /v1/match or /v1/entity.
rolefacultatifstringKeep the assets on which the company holds one of these roles, a comma list: operator, shareholder, developer, om_provider, epc_contractor, lender, offtaker, ...; only those links are shown.
limitfacultatifinteger (1..)Page size, capped by your plan. See /v1/me.
offsetfacultatifinteger (0..10000)Capped at 10000. When q is set the cap is 3000 minus your page size, because a relevance search ranks a bounded window and there is no defined order beyond it. Narrow with filters, or use /v1/changes to keep an existing set in sync.
kindfacultatifstringAsset kind: power_plant, substation, charging_station or datacenter. Valeurs: power_plantsubstationcharging_stationdatacenter
typefacultatifstringLifecycle status.
countryfacultatifstringCountry, by the full name that /v1/filters lists (for example Spain).
energy_classfacultatifstringBroad energy grouping, such as renewable or fossil. Values: /v1/filters.
energy_sourcefacultatifstringEnergy source, such as solar, wind or natural_gas. Values: /v1/filters.
generation_techfacultatifstringGeneration technology, such as pv, onshore or ccgt. Values: /v1/filters.
operatorfacultatifstringExact match on the operator name shown on the record.
capacity_minfacultatifintegerNameplate capacity, kW.
capacity_maxfacultatifintegerNameplate capacity, kW.
voltage_minfacultatifintegerkV.
voltage_maxfacultatifintegerkV.
year_minfacultatifintegerRecords with no commissioning year are always included.
year_maxfacultatifintegerLatest commissioning year. Records with no commissioning year are always included.
price_minfacultatifnumberUSD. Converted before comparison; records we cannot convert drop out.
price_maxfacultatifnumberHighest reported price, USD. Converted before comparison; records we cannot convert drop out.
addressfacultatifstringFree text matched against the street address, locality and postcode.
bboxfacultatifstringmin_lon,min_lat,max_lon,max_lat in WGS84. Rows with no coordinates never match. Prefer near/radius_km unless you genuinely have a rectangle.
nearfacultatifstringCentre point as lat,lon - for example near=53.35,-6.26. Requires radius_km, and the two are rejected unless sent together: a default radius would silently answer a different question. True great-circle distance, not a bounding square. Rows with no coordinates never match.
radius_kmfacultatifnumber (0..<501)Radius in km around near, up to 500. Beyond that the search area stops narrowing anything useful - ask it as country= or bbox= instead.
has_picturefacultatifstringSend 1 to keep only assets that have a picture. Valeurs: 1
has_namefacultatifstringSend 1 to keep only assets that have a name. Valeurs: 1
has_capacityfacultatifstringSend 1 to keep only assets with a nameplate capacity on file. Valeurs: 1
has_voltagefacultatifstringSend 1 to keep only assets with a voltage on file. Valeurs: 1
has_grid_capacityfacultatifstringSubstations with published grid-access capacity (Spain, Portugal, France, Ireland). Valeurs: 1
grid_directionfacultatifstringGrid capacity for connecting generation (default), demand or storage. Any grid_* parameter restricts to substations with a published figure for the question and orders results by it, largest first. Valeurs: generationdemandstorage
grid_technologyfacultatifstringWhat would connect: any (default), power_park, synchronous, or a word such as solar, wind, battery, gas, hydro. Decides which Spanish transmission figure applies.
grid_available_minfacultatifnumber (0..)Least capacity a SINGLE connection point must offer, in the publisher's unit (MW; MVA in Portugal and for Irish demand).
grid_free_bayfacultatifstringDrop connection points that publish zero free bays. Valeurs: 1

Exemple

curl "https://data.teraintel.com/v1/organizations/org_EXAMPLE/assets?role=shareholder&limit=25" \
  -H "Authorization: Bearer $TERA_API_KEY"
Champs de chaque fiche dans data
idstringTera's stable id (ast_, org_, per_). Survives rebuilds and merges.
kindstringAsset kind: power_plant, substation, charging_station or datacenter. Valeurs: power_plantsubstationcharging_stationdatacenter
namestringThe name as Tera records it.
statusstringLifecycle status: operating, planned, under_construction, announced, cancelled, retired, mothballed. On the Free plan a project not yet built reads in_development, with no commissioning year.
nameplate_capacityobjectNameplate (rated) capacity, as stored - kW. Not grid capacity, which is grid_capacity.
nameplate_capacity.valueintegerRated output, in the unit beside it.
nameplate_capacity.unitstringUnit of the value: kW unless the record states another.
grid_capacityobjectGrid-access capacity of a substation, present when the publisher of its network releases it: the room left for generation, storage and demand. Null otherwise.
grid_capacity.generationobjectBest connection point for generation: the room it can still take, in the unit stated, with the voltage, the queued request and the free bays.
grid_capacity.generation.availablenumberCapacity the point can still take, for any technology.
grid_capacity.generation.unitstringMW or MVA, as published. MVA is apparent power: real power is at most the MVA figure.
grid_capacity.generation.voltage_kvnumberVoltage of that connection point, kV.
grid_capacity.generation.queuednumberCapacity requested and not yet resolved; it competes for the same room.
grid_capacity.generation.bays_freeintegerFree connection bays (Spain, transmission). 0 means a new connection needs new bays, whatever the MW.
grid_capacity.generation_technologystringWhich technology the generation figure answers: power_park or synchronous. Valeurs: power_parksynchronous
grid_capacity.storageobjectBest connection point for storage: the room it can still take, in the unit stated, with the voltage, the queued request and the free bays.
grid_capacity.storage.availablenumberCapacity the point can still take, for any technology.
grid_capacity.storage.unitstringMW or MVA, as published. MVA is apparent power: real power is at most the MVA figure.
grid_capacity.storage.voltage_kvnumberVoltage of that connection point, kV.
grid_capacity.storage.queuednumberCapacity requested and not yet resolved; it competes for the same room.
grid_capacity.storage.bays_freeintegerFree connection bays (Spain, transmission). 0 means a new connection needs new bays, whatever the MW.
grid_capacity.demandobjectBest connection point for demand: the room it can still take, in the unit stated, with the voltage, the queued request and the free bays.
grid_capacity.demand.availablenumberCapacity the point can still take, for any technology.
grid_capacity.demand.unitstringMW or MVA, as published. MVA is apparent power: real power is at most the MVA figure.
grid_capacity.demand.voltage_kvnumberVoltage of that connection point, kV.
grid_capacity.demand.queuednumberCapacity requested and not yet resolved; it competes for the same room.
grid_capacity.demand.bays_freeintegerFree connection bays (Spain, transmission). 0 means a new connection needs new bays, whatever the MW.
grid_capacity.sourcestringThe publisher of the figures behind this summary.
grid_capacity.vintagestringThe publisher's edition the figures come from (e.g. 2026-08, 2026-Q2).
annual_productionobjectEnergy produced in a year (MWh).
annual_production.valuenumberEnergy produced in a year.
annual_production.unitstringAlways MWh.
voltage_kvintegerVoltage in kV (of the asset, or of a connection point).
charging_pointsintegerEV charging: vehicles that can charge at once. Not a power figure.
commissioning_yearintegerYear the asset entered service.
energyobjectThe asset's energy class, energy sources and generation technology.
energy.classstringBroad energy grouping, e.g. renewable or fossil.
energy.sourcesarray of stringThe energy sources the asset uses, such as solar, wind or natural_gas.
energy.generation_techstringGeneration technology, e.g. pv, onshore, ccgt.
locationobjectWhere the asset is: country, locality, address and coordinates.
location.countrystringCountry, by its full name.
location.country_codestringISO 3166-1 alpha-2 country code.
location.localitystringTown or city.
location.postcodestringPostal code.
location.addressstringStreet address.
location.latitudenumberWGS84 latitude.
location.longitudenumberWGS84 longitude.
location.precisionstringsite = the coordinate is the asset. area = it is the area the asset sits in. Absent means we will not claim either, which matters if you are siting anything off these numbers. Valeurs: sitearea
operatorstringThe company the record names as operating the asset.
plant_groupstringPresent when this record is one phase of a larger plant.
completenessnumber0 to 1. How much of the record we hold, not a confidence score.
sourcesarray of stringWho the values on this record came from, most-contributing first. Usually a dataset, named as its publisher names it; where we read a value off a published page it is the PUBLISHER of that page - the company whose site described the project, or the body that issued the document - never the name of our own reading process.
updated_atstringWhen the SOURCE last changed, not when our pipeline last ran.
urlstringThe record's page in Tera, for a person to check or share.
linksarray of objectOn /v1/organizations/{id}/assets: the company's current links to this asset, each with its role, share and since when; one asset can carry several (operator and shareholder).
links[].rolestringOn an asset's company, the company's role for this asset: owner, operator, developer, epc, ... On a person, their link to the company they work for: executive, board_member, founder, advisor, or employee (a department head; the people filter seniority=department_head).
links[].sharenumberOwnership share.
links[].sincestringThe date a link began, where a source states it (YYYY-MM-DD).
  • 200A page of the company's assets.
  • 402Credit allowance for the period is spent.
  • 404The id names no company in the current data set.
  • 429Rate limited. Retry-After is set.

POST/v1/match#

Match a company list to Tera ids

Crédits par appel 50 par société trouvée, 50 au minimum par appel

What it is for. Mapping the accounts in your CRM or warehouse to Tera's companies, the first step of an enrichment: send your list, store the ids that come back, then open the companies you need with /v1/entity.

Each candidate is tried on its register number, then its website, then its name, and comes back in order with its match, a confidence and what it matched_on. exact: one company carries that register number or website. strong: several companies share the website (a group and its subsidiaries), or the name is the candidate's exactly in its country; the others come back as alternatives. weak: the best name hit, to be checked against the alternatives. none: nothing found, and match is null.

A match is a finder (id, name, country, url): the record is /v1/entity, at its own rate. 50 credits a candidate matched and at least 50 a call; matched candidates count as rows against a prepaid key's month. At most 25 candidates a call on a prepaid key.

Corps de la requête
candidatesarray of objectThe companies to match, in the order you want the answers.
candidates[].refstringYour own reference for the candidate (a CRM id), echoed back on its answer.
candidates[].namestringThe company's name as you hold it.
candidates[].countrystringAn ISO 3166-1 alpha-2 code or a country name. Narrows a name match, and lets a bare register number match.
candidates[].websitestringThe company's website, as a URL or a bare domain. Social networks and site builders are ignored.
candidates[].register_idstringThe company's register number, as Tera writes it (GB-COH-01234567) or bare with a two-letter country.

Exemple

curl "https://data.teraintel.com/v1/match" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"candidates":[{"ref":"crm-1042","name":"Orsted","country":"DK","website":"orsted.com"}]}' \
  -H "Authorization: Bearer $TERA_API_KEY"
Champs de chaque fiche dans data
refstringOn /v1/match: the reference the caller sent with the candidate (its own CRM id), echoed back; the candidate's position when none was sent.
matchobjectOn /v1/match: the company the candidate matched, as a finder (id, name, country, url); null when none did. /v1/entity returns the record.
match.idstringTera's stable id (ast_, org_, per_). Survives rebuilds and merges.
match.namestringThe name as Tera records it.
match.countrystringCountry: by full name on /v1 and MCP records; the ISO 3166-1 alpha-2 code on /v1/public/company-lookup items, and in hq, projects and similar on /v1/public/companies.
match.urlstringThe record's page in Tera, for a person to check or share.
confidencestringOn /v1/match: exact (one company carries the register number or website), strong (a shared website, or the exact name in its country) or weak (the best name hit; check the alternatives); none when nothing matched. In estimates: how much of the estimate rests on sourced inputs and a country benchmark, 0 to 1. Lower when a technology, year or geography was assumed, a solar plant's capacity is stated in an unknown basis (AC or DC), or a datacenter is priced on its planned IT load. Valeurs: exactstrongweaknone
matched_onarray of stringOn /v1/match: the evidence the match rests on: register_id, website or name. Valeurs: register_idwebsitename
alternativesarray of objectOn /v1/match: up to three other companies the candidate could be, as finders, most likely first.
alternatives[].idstringTera's stable id (ast_, org_, per_). Survives rebuilds and merges.
alternatives[].namestringThe name as Tera records it.
alternatives[].countrystringCountry: by full name on /v1 and MCP records; the ISO 3166-1 alpha-2 code on /v1/public/company-lookup items, and in hq, projects and similar on /v1/public/companies.
alternatives[].urlstringThe record's page in Tera, for a person to check or share.
  • 200One answer per candidate, in order.
  • 400The body is not a list of candidates, a candidate has no name, website or register_id, or the list is longer than the key's page.

GET/v1/people#

Electricity-market professionals

Crédits par appel 500

What it is for. Finding who to talk to: the leadership and the department heads (grid connections, procurement, origination, asset management and the like) at the companies you target. Go from a company or an asset's owner to a named person here, then call POST /v1/people/{id}/email for their verified work email when you are ready to write. It returns what the People list in Tera shows, with every email hidden until it is revealed.

An empty result means we hold nobody for the query, not that nobody exists; meta.coverage repeats that on every response. On a prepaid key contact.linkedin_available says whether we hold the person's LinkedIn page; the link itself is part of a licence.

Paramètres
qfacultatifstringFree-text search. Distinctive words must match; generic industry words (plant, power, solar, farm, ltd) only affect ranking, so "solar farm cork" returns Cork assets rather than nothing. Accent- and case-insensitive, tolerant of typos, and unit numbers are equivalent ("hornsea two" finds "Hornsea 2"). Acronyms resolve on organizations and employers. Results come back in relevance order, which is the same engine and the same ranking the Tera app itself searches with. A query containing nothing distinctive ("solar", "power plant" - only generic industry words) is refused with 400: it matches tens of thousands of records and ranks them all alike, so there is no useful answer to give. Ask those as filters instead (energy_source=solar, kind=power_plant), which is both exact and fast.
limitfacultatifinteger (1..)Page size, capped by your plan. See /v1/me.
offsetfacultatifinteger (0..10000)Capped at 10000. When q is set the cap is 3000 minus your page size, because a relevance search ranks a bounded window and there is no defined order beyond it. Narrow with filters, or use /v1/changes to keep an existing set in sync.
countryfacultatifstringCountry, by the full name that /v1/filters lists (for example Spain).
organizationfacultatifstringAn organization id from this API (org_...).
has_emailfacultatifstringSend 1 to keep only people we hold a work email for. The address stays hidden until you reveal it (POST /v1/people/{id}/email). Valeurs: 1
has_phonefacultatifstringSend 1 to keep only people we hold a phone number for. Valeurs: 1
has_picturefacultatifstringSend 1 to keep only people who have a picture. Valeurs: 1

Exemple

curl "https://data.teraintel.com/v1/people?country=Spain&limit=5" \
  -H "Authorization: Bearer $TERA_API_KEY"
Champs de chaque fiche dans data
idstringTera's stable id for the person (per_).
namestringThe name as Tera records it.
positionstringJob title.
organizationobjectThe company the person works for: its id, name and page.
contactobjectlinkedin_url (on a licence key; a prepaid key reads linkedin_available instead), plus email_available and phone_available - booleans saying whether we hold a direct contact for this person. The email and phone values themselves are returned only to a key carrying the read:contacts scope, which blanket 'read' does not grant. Without it you learn that a contact exists and can send the user to the entity url; you do not receive the address.
locationobjectWhere the person is based: country and locality.
updated_atstringWhen a source last changed this record.
urlstringThe record's page in Tera, for a person to check or share.
  • 200A page of people.

GET/v1/entity#

Get a full record

Crédits par appel 500, 100 pour une borne de recharge, 800 pour un poste avec capacité d'accueil

What it is for. Opening one record in full, as its page in Tera does: an asset with its shareholders, developer, operator, offtaker and lenders, or a company with its assets, its owners and its people. Use it to check a counterparty before a deal, to see who stands behind a project, or to refresh a record you store. A prepaid key that has not topped up reads an asset without its estimates and grid_capacity, at the record's base rate, and meta.withheld names them.

Three distinct answers, and a sync that collapses them will delete records it should have kept:

  • 404 we never issued this id.
  • 200 with `meta.state = "absent"` we know the id, the entity is not in the current data set. Keep your record and flag it; you will see a restored event if it returns.
  • 200 with `meta.redirected_from` the id you sent was merged into another entity. Store data[0].id from now on. The old id keeps resolving here indefinitely.
Paramètres
idobligatoirestringThe id to look up: ast_, org_ or per_. An id that was merged resolves to the entity it went into.

Exemple

curl "https://data.teraintel.com/v1/entity?id=ast_EXAMPLE" \
  -H "Authorization: Bearer $TERA_API_KEY"
  • 200The entity, or an empty data array with meta.state = absent.
  • 404Unknown id.

GET/v1/changes#

What happened to the records you watch

Crédits par appel 200, plus 100 par tranche de 25 lignes supplémentaires

What it is for. Knowing when something happens to the companies and assets your team follows: an owner buys or sells a stake, a project moves to construction, a plant is uprated, a new phase is announced. Put the records on a watchlist (/v1/watchlists) and read their events here, then refetch only what moved.

Part of a licence. A prepaid key is refused here and on /v1/watchlists (403). Your licence names how many records the account may watch.

Typed events. status_changed and capacity_changed carry from and to; updated names the other fields that moved in changed_fields; ownership_changed is a company-to-asset link added, ended or re-shared, on both ends, with the role and the shares; phase_added names a new phase of the plant; merged gives the id to keep in redirect_to (the watchlist follows it); removed and restored say a record left the current data set or came back. Each record's events start when it was added to a list.

Pass watchlist to read one list. Store the next_cursor from each response and pass it back as ?since=; every event of one change shares its cursor.

Paramètres
sincefacultatifintegerCursor from a previous response. Omit for the beginning.
watchlistfacultatifstringRead one of the account's watchlists; without it, every list.
limitfacultatifinteger (1..)Page size, capped by your plan. See /v1/me.

Exemple

curl "https://data.teraintel.com/v1/changes?since=0&watchlist=crm-accounts&limit=100" \
  -H "Authorization: Bearer $TERA_API_KEY"
Champs de chaque fiche dans data
cursorintegerPass the last one you processed back as ?since=.
idstringThe id of the entity that changed.
typestringThe kind of record that changed: asset, organization or person. Valeurs: assetorganization
eventstringWhat happened: status_changed or capacity_changed (from, to), updated (other fields; changed_fields names them), ownership_changed (a company-to-asset link added, ended or re-shared), phase_added (a new phase joined the plant), merged (redirect_to is the id to keep), removed or restored. Valeurs: status_changedcapacity_changedupdatedownership_changedphase_addedmergedremovedrestored
redirect_tostringOn a merge, the id to store from now on.
changed_fieldsarray of stringOn an updated event: the /v1 fields whose value changed (status, location, operator, ...), in the record's order. Absent on a change recorded before Tera kept field-level history.
fromstring or numberThe value before the change: a status, or a nameplate capacity in kW.
tostring or numberThe value after the change: a status, or a nameplate capacity in kW.
actionstringOn ownership_changed: added (a new link), ended (the link is gone) or share_changed (the same link with another share). Valeurs: addedendedshare_changed
organizationstringThe company the person works for. On /v1/organizations/{id}/assets: the company whose portfolio this is. On an asset's ownership_changed event: the company the link is to.
assetstringOn a company's ownership_changed event, the asset the link is to; on phase_added, the new phase.
rolestringOn an asset's company, the company's role for this asset: owner, operator, developer, epc, ... On a person, their link to the company they work for: executive, board_member, founder, advisor, or employee (a department head; the people filter seniority=department_head).
share_fromnumberOn ownership_changed: the share before the change, in percent; absent on a new link or one with no stated share.
share_tonumberOn ownership_changed: the share after the change, in percent; absent on an ended link or one with no stated share.
plant_groupstringKey shared by the phases of one multi-phase plant. A grp: or dcc: key names the group by its aggregate asset, with that asset's id in this API (since 2026-10-28; it carried an internal number before).
atstringWhen the change was recorded (ISO 8601).
  • 200A page of changes.
  • 404No watchlist of that name on this account.

GET/v1/watchlists#

Your watchlists

Crédits par appel Gratuit

What it is for. Seeing the lists of companies and assets the account follows, and how many more it may watch (meta.watched_ids of meta.max_watched_ids, the allowance your licence names).

Part of a licence: a prepaid key is refused (403). Managing a list costs no credits; reading its events on /v1/changes does.

Cet appel n'a aucun paramètre.

Exemple

curl "https://data.teraintel.com/v1/watchlists" \
  -H "Authorization: Bearer $TERA_API_KEY"
Champs de chaque fiche dans data
namestringThe name as Tera records it.
countintegerNumber of records: in a page, a bucket or a portfolio. In a /v1/stats country signal, the plants or companies the signal counts.
created_atstringWhen it was created.
updated_atstringWhen a source last changed this record.
  • 200The account's lists.
  • 403A prepaid key, or a key with no account.

GET/v1/watchlists/{name}#

The records on a watchlist

Crédits par appel Gratuit

What it is for. Reading back a list, paged: each record's id, the id it was watched as when a merge has given it another, and when it was added (its events start there).

Part of a licence: a prepaid key is refused (403). Managing a list costs no credits; reading its events on /v1/changes does.

Paramètres
nameobligatoirestringThe list's name: 1 to 48 lowercase letters, digits, - or _.
limitfacultatifinteger (1..)Page size, capped by your plan. See /v1/me.
offsetfacultatifinteger (0..10000)Capped at 10000. When q is set the cap is 3000 minus your page size, because a relevance search ranks a bounded window and there is no defined order beyond it. Narrow with filters, or use /v1/changes to keep an existing set in sync.

Exemple

curl "https://data.teraintel.com/v1/watchlists/crm-accounts" \
  -H "Authorization: Bearer $TERA_API_KEY"
Champs de chaque fiche dans data
idstringTera's stable id (ast_, org_, per_). Survives rebuilds and merges.
watched_asstringThe id the record was put on the list under, when a merge has since given it another (id).
typestringThe kind of record: asset, organization or person; on a search result, what was searched. Valeurs: assetorganization
added_atstringWhen the record was put on the list; its events start there.
  • 200A page of the list's records.
  • 404No watchlist of that name.

PUT/v1/watchlists/{name}#

Write a watchlist

Crédits par appel Gratuit

What it is for. Following a set of companies and assets: your CRM accounts, a portfolio, a pipeline. The body is the whole list (it creates the list or replaces it); an id already on it keeps when it was added. Ids from /v1/organizations, /v1/assets, /v1/match or /v1/entity, up to 5,000 a list; an id that names no current company or asset comes back in unknown.

The account's lists together may watch the records its licence names; past that the call is refused (403).

Part of a licence: a prepaid key is refused (403). Managing a list costs no credits; reading its events on /v1/changes does.

Paramètres
nameobligatoirestringThe list's name: 1 to 48 lowercase letters, digits, - or _.
Corps de la requête
idsarray of stringEvery company and asset id the list should hold.

Exemple

curl "https://data.teraintel.com/v1/watchlists/crm-accounts" \
  -X PUT \
  -H "Content-Type: application/json" \
  -d '{"ids":["org_EXAMPLE","ast_EXAMPLE"]}' \
  -H "Authorization: Bearer $TERA_API_KEY"
Champs de chaque fiche dans data
namestringThe name as Tera records it.
countintegerNumber of records: in a page, a bucket or a portfolio. In a /v1/stats country signal, the plants or companies the signal counts.
addedintegerOn a watchlist written: the ids put on it by this call.
removedintegerOn a watchlist written: the ids taken off it by this call.
unknownarray of stringOn a watchlist written: the ids that name no current company or asset; they are not watched.
  • 200The list as written.
  • 400A bad name or body.
  • 403Past the account's allowance, or a prepaid key.

DELETE/v1/watchlists/{name}#

Drop a watchlist

Crédits par appel Gratuit

What it is for. Dropping a list you no longer follow. Its records stop appearing on /v1/changes unless another list holds them.

Part of a licence: a prepaid key is refused (403). Managing a list costs no credits.

Paramètres
nameobligatoirestringThe list's name: 1 to 48 lowercase letters, digits, - or _.

Exemple

curl "https://data.teraintel.com/v1/watchlists/crm-accounts" \
  -X DELETE \
  -H "Authorization: Bearer $TERA_API_KEY"
  • 200The list is gone.
  • 404No watchlist of that name.

GET/v1/filters#

The query grammar and its current values

Crédits par appel Gratuit

What it is for. Learning which countries, technologies, statuses and other values each filter accepts, before you build a query, or a form on top of the API.

Free. Fetch this instead of hard-coding vocabularies: it is generated from the same code that runs the queries, so it cannot drift from what the API accepts.

Paramètres
entityfacultatifstringWhich list to describe: assets, organizations or people. Omit for all three. Valeurs: assetsorganizationspeople
kindfacultatifstringFor entity=assets: report the vocabulary for one asset kind.

Exemple

curl "https://data.teraintel.com/v1/filters?entity=assets" \
  -H "Authorization: Bearer $TERA_API_KEY"
  • 200Filters, values and ranges.

GET/v1/me#

What this key is and what it has spent

Crédits par appel Gratuit

What it is for. Checking that a key works and how much of its allowance is left.

Free. The quickest way to check a key works and to see the limits that apply to it.

Cet appel n'a aucun paramètre.

Exemple

curl "https://data.teraintel.com/v1/me" \
  -H "Authorization: Bearer $TERA_API_KEY"
  • 200Scopes, limits and credit usage.

GET/v1/stats#

How much data Tera holds

Crédits par appel Gratuit

What it is for. The size of the dataset at a glance: how many assets, companies and people Tera holds, and in how many countries.

Free. Entity counts for the whole dataset, served from a snapshot rather than computed live (the honest counts take several seconds, which is both slow and a cheap way to make us do expensive work). as_of says when the snapshot was taken.

Two units, each named, never summed. The top-level figures are CURATED ENTITIES: resolved records with source provenance, not raw source rows. reference_geo is a different unit: the feature count of the mapped grid layers (towers, lines, generators, substations and more), which is far larger and describes something else. Each block carries its own unit and note; do not add them together, and do not quote one figure against the other definition.

by_country counts curated entities per ISO 3166-1 alpha-2 country code (substations, operating plants, plants in development, data centres, charging stations, substations with published headroom). Counts only, no capacity totals.

A block that has not been computed on this host answers {"state": "unavailable"} rather than zeroes.

Cet appel n'a aucun paramètre.

Exemple

curl "https://data.teraintel.com/v1/stats" \
  -H "Authorization: Bearer $TERA_API_KEY"
  • 200Curated entity counts, reference-geo feature counts and source counts, with the date of the snapshot.

GET/v1/aggregate#

Grouped counts and totals

Crédits par appel 300

What it is for. Sizing a market in one call, for a market map, a pitch or a study: the megawatts of solar by country, the largest operators of wind in a country, the plants commissioned each year. Use it where the totals matter more than each record.

Answers how much, so you do not have to page records and add them up. Accepts the same filters as /v1/assets, from the same catalog, so ?country=Spain&energy_source=solar selects exactly the rows the list route would return.

group_by is required and must be one of the dimensions /v1/filters publishes under aggregate.group_by. Buckets are ordered by the largest measure and capped at limit (default 50, max 500), so a high-cardinality dimension like operator gives you the top N rather than every operator.

A null bucket is kept, not dropped. It means the field is not recorded on those rows, and it can be the largest bucket. Dropping it would give you a league table whose leader is an artefact of what we do not hold.

nameplate_capacity_mw omits rows with no capacity on file. Call /v1/coverage for the same slice before quoting a total. A prepaid key that has not topped up reads no valuation total.

q is refused here: an aggregate over a relevance search would total a different set than the one you searched. Express it as filters.

Beyond group_by and entity, this route takes the filters of the entity it totals (/v1/assets or /v1/organizations).

Paramètres
group_byobligatoirestringThe dimension to group by. Required. The dimensions are listed by GET /v1/filters under aggregate.group_by.
entityfacultatifstringWhat to total: assets (the default) or organizations. Valeurs: assetsorganizations
limitfacultatifinteger (1..)Page size, capped by your plan. See /v1/me.

Exemple

curl "https://data.teraintel.com/v1/aggregate?group_by=energy_source&country=Spain" \
  -H "Authorization: Bearer $TERA_API_KEY"
  • 200One row per bucket, ordered by the largest measure.
  • 400Unknown or missing group_by, limit out of range, or q supplied.

GET/v1/coverage#

How much of each field we hold, for a slice

Crédits par appel Gratuit

What it is for. Knowing how far to trust a gap. Before a model or a report reads a missing operator or capacity as meaningful, ask how often Tera holds that field for the same slice of the market.

Free. Tells you whether a missing field in a record is unusual. Coverage is measured over a slice: name a country or a kind (assets), a country or a type (organizations), a country or an organization (people). A prepaid key asks 50 coverage questions a UTC day.

A record that omits operator says nothing on its own about whether we normally record one. This route answers that for exactly the rows your filters select, so you can tell we do not hold this from this does not exist - the two readings that collapse into one if you only ever see records.

Coverage varies by slice, which is the point. Quote the figure for the slice you asked about.

Percentages are of matched, the rows these filters select. A low percentage means we do not hold the field for those rows; it is not evidence the fact is absent in the world.

Beyond entity, this route takes the filters of the entity it measures, to describe the slice.

Paramètres
entityfacultatifstringWhich records to measure: assets (the default), organizations or people. Valeurs: assetsorganizationspeople

Exemple

curl "https://data.teraintel.com/v1/coverage?entity=assets&country=Spain" \
  -H "Authorization: Bearer $TERA_API_KEY"
  • 200Matched row count, and recorded count plus percent per field.
  • 400Unknown entity, a rejected filter, or q supplied.

POST/v1/people/{id}/email#

Get a person's verified email

Crédits par appel 500

What it is for. Getting a person's work email when your team is ready to contact them, one person at a time.

Needs the read:contacts scope. Every email is hidden until your subscription reveals it; once revealed it also comes back on /people and /entity for every key of the subscription. Counts against the subscription's daily reveal limit; an address revealed before answers again without counting. 500 credits for an address delivered the first time; pending, not_found, not_available and an address revealed before cost nothing. state pending means a lookup is still running: call again.

Paramètres
idobligatoirestringA person id from this API (per_...), from /v1/people or /v1/entity.

Exemple

curl "https://data.teraintel.com/v1/people/per_EXAMPLE/email" \
  -X POST \
  -H "Authorization: Bearer $TERA_API_KEY"
  • 200The state and, when found, the email and when it was last checked.
  • 429The daily reveal limit is reached.