---
title: "Get all accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# Get all accounts

`GET /accounts`

## Request

- Base URL: `https://api.app.subskribe.com`
- URL: `https://api.app.subskribe.com/accounts`
- Auth: API key in header `X-API-Key`

Returns a paginated list of accounts

## Query parameters

- `cursor` string, uuid
- `limit` integer
- `type` string

## Response `200`

successful operation

- PaginatedAccountsResponse
  - `data` AccountJson[]
    - `id` string: This is a system-generated Account ID
    - `name` string, required: Account name
    - `legalName` string: (optional) Account legal name
    - `description` string: (optional) Account Description
    - `phoneNumber` string: (optional) Phone number of the Account
    - `timezone` string
    - `crmId` string: (optional) CRM ID of the Account
    - `crmType` string: (optional) CRM type
    - `erpId` string: (optional) ERP ID of this account
    - `externalId` string: (optional) External ID of this account
    - `currency` string: The currency code (ISO 4217 format). If currency is not entered, USD will be applied by default. Possible currencies in Subskribe: AED AUD CAD CHF CZK DKK EUR GBP HKD INR MXN NOK NZD SAR SEK SGD TWD USD
    - `taxExemptionUseCode` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'P' | 'Q' | 'R': (optional) Indicates Tax Exemption Information. When the account does not qualify for Tax Exemption, add null in the request. When using Anrok Tax Integration, keep this value null , as Anrok requires to upload Tax Exemption Certificate.
    - `isReseller` boolean: (optional) Input true, if this is a Reseller Account. Default is false
    - `hasAutomaticPayment` boolean: (optional) Input true, if this Account will have an automatic payment. Default is false
    - `excludeFromBatchOperations` boolean: (optional) Input true, if this account needs to be excluded from Batch Operations like Bulk Invoice Run, Invoice Generation. Default is false. This is an optional field.
    - `excludeFromDunning` boolean: (optional) Input true, if this account needs to be excluded from Dunning emails. Default is false. This is an optional field.
    - `supportedPaymentTypes` string[]: (optional) Supported payment types for this Account. This field can include various payment types such as ACH, Card, Check, Wire, and Invoice. This is an optional field.
    - `address` AccountAddressJson
      - `streetAddressLine1` string: Address Line 1 of the Contact
      - `streetAddressLine2` string: Address Line 2 of the Contact
      - `streetAddressLine3` string: Address Line 3 of the Contact
      - `city` string: City of the Contact
      - `state` string: State Code of the Contact (ISO 3166-2 state/province code). Currently supported for USA, Canada. For instance, for Arizona (USA), set state as AZ (not US-AZ).For British Columbia (Canada), set as BC (not CA-BC)
      - `country` string: Country Code of the Contact ( ISO 3166 alpha-2 country code).
      - `zipcode` string: Zip or Postal Code of the Contact
    - `updatedOn` integer: (optional) will be auto-populated as today's date
    - `customFields` object: (optional) Use this option to create custom fields for the Account object if you need to collect Account-specific information, such as region, age, or gender.
    - `entityIds` string[]: (optional) Enter the entity ID where this Account belongs to
  - `numElements` integer
  - `nextCursor` string, uuid

---

[API](https://skmtc.dev/dealhub/apis/subskribe-api.md) - [All operations](https://skmtc.dev/dealhub/apis/subskribe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dealhub/apis/subskribe-api/revisions/c1ee531b82ce?raw)