MOmonaco
Accounts

List Accounts

Changed on

Returns a paginated list of accounts.

Custom fields — list items omit custom_field_<uuid> keys by default. Pass include_custom_fields: true to include them; GET /v1/accounts/{account_id} always returns them.

post/v1/accounts/list

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/accounts/list
  • Auth
    none declared

Request body

pageinteger

Page number (1-indexed)

page_sizeinteger

Number of results per page

sortstring

Field to sort by. Prefix with '-' for descending order.

include_custom_fieldsboolean

Whether to include custom fields on each returned account. Defaults to false. Set true to include custom_field_<uuid> keys on each returned account; GET /v1/accounts/{account_id} always returns them.

Example request

{
  "page": 1,
  "page_size": 25,
  "sort": "-created_at"
}

Response

Successful Response

Example response

{
  "data": [
    {
      "id": "acc_abc123",
      "name": "Acme Corp",
      "status": "PROSPECTING",
      "owner": {
        "id": "usr_abc123",
        "first_name": "Jane",
        "last_name": "Smith"
      },
      "parent_account": {
        "id": "acc_abc123",
        "name": "Acme Holdings"
      },
      "notes": "Key enterprise prospect",
      "domains": [
        "acme.com",
        "acme.io"
      ],
      "company": {
        "domain": "acme.com",
        "linkedin_url": "https://linkedin.com/company/acme",
        "description": "Enterprise software company specializing in AI-driven sales tools",
        "employee_count": 250,
        "founded_year": 2019,
        "industries": [
          "Software",
          "Artificial Intelligence"
        ],
        "total_funding_usd": 50000000,
        "last_funding_date": "2024-03-15",
        "company_name": "Acme Corporation",
        "estimated_annual_revenue_usd": 12000000,
        "last_funding_round": "series_b",
        "business_model": "B2B",
        "company_status": "active",
        "location": "San Francisco, CA, United States"
      },
      "overridden_fields": [
        "industries",
        "domains"
      ],
      "scoring": {
        "tier": "A",
        "heat_score": "Hot"
      },
      "tags": [
        "Enterprise",
        "High Priority"
      ],
      "created_at": "2025-06-15T10:30:00Z",
      "updated_at": "2025-06-15T10:30:00Z",
      "last_activity_at": "2025-06-15T10:30:00Z",
      "last_activity_type": "outbound_email",
      "last_contacted_at": "2025-06-15T10:30:00Z",
      "last_contacted_type": "email",
      "last_inbound_at": "2025-06-15T10:30:00Z",
      "last_inbound_type": "email"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_count": 142,
    "total_pages": 6
  }
}

Changes

  • fc720ada2a81Revision changes
    • breaking

      removed subschema #1 from the request property anyOf list

    • info

      the request property default value changed from true to false

    • info

      added subschema #1 to the request property oneOf list

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status