List connections
API Documentation / Resources / Connections and subsidiaries
Returns the active connection represented by the access token. No additional resource scope is required beyond a valid connection grant. The collection shape supports clients that store several separately authorized subsidiaries, although a subsidiary-bound token normally returns one item.
GET /v1/connections?page=1&per_page=30 HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Accept: application/json
Query parameters
| Parameter | Required | Description |
|---|---|---|
page |
No | Page number. Defaults to 1. |
per_page |
No | Records per page from 1 to 100. Defaults to 30. |
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": [
{
"id": "42ea765a-9d2e-4cc8-a196-2e7282a6813c",
"tenant_id": "07224707-2351-46b4-a810-5fee961b5823",
"subsidiary_id": "84224707-2351-46b4-a810-5fee961b6373",
"subsidiary_name": "Aster Ridge New Zealand Limited",
"scopes": [
"accounting:read",
"invoices:read"
],
"created_at": "2026-08-10T09:30:00Z",
"updated_at": "2026-08-10T09:30:00Z"
}
],
"meta": {
"current_page": 1,
"per_page": 30,
"last_page": 1,
"total": 1
}
}