Quickstart

You exchange your long-lived API key for a short-lived token, then list your Monterey accounts.

Prerequisites

An API key scoped to at least one organization
The accounts:read API permission on that key
The key prefix shown in the client portal
curl and jq

1. Mint an access token

set -o pipefail
ACCESS_TOKEN=$(curl --fail-with-body -sS -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "mfs_AbCd1234",
    "client_secret": "mk_your_key_here"
  }' \
  https://api.montereyfinancial.app/v1/oauth/token | jq -er .access_token)

The access token expires after 3600 seconds. Keep the API key in your secret store and re-run the exchange before expiry.

2. List accounts

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
  "https://api.montereyfinancial.app/v1/accounts?limit=100"

A successful response includes items and pagination metadata:

{
  "items": [
    {
      "id": "01J...",
      "organization_id": "01K...",
      "external_id": "00012345",
      "external_contract_id": "YOUR-CONTRACT-12345",
      "borrowers": [
        {
          "party_id": "01J...",
          "display_name": "Jane Smith",
          "role": "primary",
          "is_primary": true
        }
      ]
    }
  ],
  "page": {
    "next_cursor": null,
    "has_more": false,
    "limit": 100
  }
}

If next_cursor is not null, pass it as the next request’s cursor parameter.

Authentication

Token exchange, expiry, API-key rotation, and authorization errors.

Conventions

Rate limits, pagination, dates, money, and shared errors.

Domain concepts

Organizations, people, borrower roles, accounts, and transactions.

Getting started

Core concepts

How-to guides

Prerequisites

1. Mint an access token

2. List accounts

What to read next

Authentication

Conventions

Domain concepts

​Prerequisites

​1. Mint an access token

​2. List accounts

​What to read next

Authentication

Conventions

Domain concepts

Prerequisites

1. Mint an access token

2. List accounts

What to read next