finov.ioDocumentationHome

Get a subsidiary

API Documentation / Resources / Connections and subsidiaries

Finovio Subsidiary settings page showing identity calendar lock and synchronization settings
Identity, reporting calendar, and lock controls apply to the selected subsidiary.

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"
  }
}