Get a subsidiary
API Documentation / Resources / Connections and subsidiaries

Get subsidiary context
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}
Required OAuth scope: accounting:read
Returns legal identity, functional currency, year-end, tax, and accounting lock details for the subsidiary selected by the OAuth grant.
| Field | Integration significance |
|---|---|
functional_currency |
Currency used for the subsidiary ledger and reports. |
financial_year_end |
Current financial-year boundary. |
locked_date |
Mutations dated on or before this date are prohibited. |
country_code |
ISO 3166-1 alpha-3 jurisdiction code. |
Subsidiaries are managed through Finovio and cannot be mutated through v1.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
tenant_id |
path | Yes | string (uuid) | UUID of the authorized company group. |
subsidiary_id |
path | Yes | string (uuid) | UUID of the subsidiary whose books contain the bank account. |
Request
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id} HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
200 |
Subsidiary context. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
200 example
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"id": "84224707-2351-46b4-a810-5fee961b6373",
"legal_name": "Aster Ridge New Zealand Limited",
"country_code": "NZL",
"functional_currency": "NZD",
"financial_year_end": "2027-03-31",
"tax_number": "123-456-789",
"locked_date": "2026-06-30",
"updated_at": "2026-08-10T09:30:00Z"
}
}