PANADATA

Search Entities

Search organizations and natural persons by name and/or RUC. Returns summaries, each with a typed `id` (e.g. pa_own_42) to pass to get_entity / get_real_estate. Provide at least one of q/ruc. For disambiguation with confidence scoring, prefer resolve_entity.

Resolve Entity

Resolve a name/ruc/cédula to **ranked candidate entities** — each with a typed `gid`, a `confidence` score, and `matched_on` (which field matched). This is probabilistic: it returns candidates, NOT a single certain answer — inspect confidence and pick. Use FIRST to turn a vague reference like 'my Fundación' into a concrete typed id before get_entity / get_real_estate / list_dockets.

Get Entity

Fetch an entity (or any addressable asset) by its typed id. For an entity, `include` product codes unlock data sections and add cost (charged only on success). An asset id returns that asset directly — no `include` needed. SEARCH → DETAIL CHAINING — only 7 of `search`'s 14 surfaces return an addressable id. On those, the hit's `id` is already a typed id for this tool: pass it through VERBATIM (never rebuild, prefix-strip or renumber it — the gateway is the only id codec). importaciones pa

Get Entities Batch

Resolve many typed ids in one call. Returns one record per id with found=true/false. Cheaper round-trips when you already hold a set of ids (e.g. owner_ref / related refs).

Search Gov Entities

Find Panama GOVERNMENT ENTITIES (ministries, autonomous authorities, municipalities, juntas comunales, public schools, hospitals, notaries, embassies…) by any spelling. Returns rows with a typed `id` of the **`pa_gov_` family — a catalogue with its own identity, NOT `pa_own_`** (an institution is not an organization/person entity; pass a `pa_gov_` id only to `get_gov_entity` or `get_entity`, never to owner-only tools like `get_real_estate` / `list_dockets`). Ranking: exact normalized alias firs

Get Gov Entity

Detail of one Panama government entity by its `pa_gov_` id: `nombre_canonico`, `tipo`, `provincia`, `fuente`, `parent`, **`rucs[]` = ALL its tax ids** (the Autoridad Marítima has two: 8-NT-1-12532 and 8-NT-2-22734 — an institution can hold several RUC-NT, and the same RUC-NT can never be a natural person), and `aliases[]` = every known spelling with `fuente` (dgi_n30 / manual / planillas…) and `confianza`. If the id was merged into another entity the response is the surviving one with `redirecte

Resolve Gov Entities

Map a CLIENT'S LIST of institution names (a spreadsheet column, a contract's parties, a payroll's employers) to Panama government entities. Response envelope: `{results: [...], note: "..."}` — `results` has one row per input IN ORDER: `{input, entity_id (pa_gov_ or null), nombre_canonico, match, score, alternativas[]}`. `match`: `alias_exacto|nombre_norm` = identity · `auto` = similarity above the ingest threshold (would be accepted; NOT persisted here) · `ambiguo` = homonyms, see `alternativas`

Get Real Estate

Real-estate portfolio for an entity. Each property includes valor, superficie (m²), valor_estimado, a typed `id`, and **precio_por_m2** (price per m², from the building's average price), plus a `summary` with the superficie-weighted average price per m². This answers 'what is the average price per square meter for X's apartment(s)'. Bills DAT-ASSET + base fee (charged only on success). NOTE: `valor` is the value DECLARED AT INSCRIPTION (historical), NOT market value or last sale price; `precio_p

List Dockets

List an entity's Public-Registry dockets (entradas = scanned, elementos = digital). Each item has a typed `id` and a `has_ocr_text` flag — pass its id to get_docket to read the OCR'd text. These deeds are where ACTUAL transaction values live (compraventa / valor_traspaso = real sale price, hipoteca = mortgage) — unlike the inscription `valor`. OCR coverage is PARTIAL: only items with has_ocr_text=true have readable text; if the deed you need isn't OCR'd yet, request_real_estate_update re-scrapes

Get Docket

Fetch a single docket with full metadata and its **ocr_text** — the OCR'd text of the scanned document (plus finalizacion_text when present). The docket id encodes whether it's an entrada or elemento. Scoped to the owning entity. Bills DAT-DOC + base.

Get Entity Records

List one category of an entity's records, paginated. Covers trade (importaciones/exportaciones + the derived `trade-profile`), licitaciones, noticias, contraloria, avisos, marcas, gacetas, `legal` (judicial expedientes), naves, movable-assets, fideicomisos, licenses, immigration, planillas; the director/shareholder `network`; AML `screening` (sanctions + PEP); `score` (panadata_score + counters); and `proponente-dossier` — bidder document intelligence for a company (beneficial ownership / financ

Search

Cross-entity **faceted search** over a dataset — no entity id needed. The response leads with **facets/aggregations** (trade: top importers/HS/country + monthly CIF + total; licitaciones: spend by entidad/estado + top awardees; avisos: by industry/location for lead-gen; contraloria: spend by institución; real-estate: by district/value-band + valor stats (filter on valor_min/max, codigo_ubicacion); noticias: adverse-media by risk_category + is_risky + risk_score; immigration: by_source/by_tipo/by

Search By Role

Relational search: find the **organizations where a person/firm holds a role** (agente residente, director, tesorero, …). Identify the actor by typed `owner_id` or by `name`. The response leads with `by_cargo` (the actor's role distribution across all their entities — e.g. agente residente of 753) plus a page of the organizations. Bills DAT-NETWORK + base fee.

Request Entity Update

Trigger an async refresh (re-scrape) of an OWNER (organization / persona). Returns an update_request id; poll it with get_update_status. For real-estate assets (finca / PH) use request_real_estate_update instead.

Request Real Estate Update

Trigger an async re-scrape of a real-estate asset (finca / propiedad horizontal) by its typed id. Repulls the property AND its registry dockets — entradas/elementos including the constitution / MIVI resolution deeds — then PDF-download + OCR into the data layer (a self-completing automatic-lane job). Returns an update_request id. Afterwards the refreshed dockets are readable via list_dockets / get_docket (which accept finca/ph ids) and get_entity on the entrada/elemento id.

Get Update Status

Poll the status of an async update request created by request_entity_update.

List Product Codes

Live product-code catalog from `GET /v5/catalog` — the billing source of truth, never a local mirror. Returns **the gateway body verbatim**, so read the keys off the response, not off this docstring: the gateway adds keys to that 200 and an enumeration here would go stale without breaking anything. What the body is for: - `products` maps each product CODE → `{cost, tags}`, and `base_cost` is the fee every authenticated request pays on top of the codes. Both are decimal STRINGS — exact, so do