finov.ioDocumentationHome

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