List accounts
GET/v2/accounts
Fetches multiple account records. The records can be filtered, paged, and sorted according to the respective parameters.
Request
Query Parameters
IDs of accounts to fetch. If a record can't be found, that record won't be returned and your request will be successful
Filters accounts by crm_id. Multiple crm ids can be applied
Filters accounts by the tags applied to the account. Multiple tags can be applied
Filters accounts by the tag id's applied to the account. Multiple tag id's can be applied
Returns all matching records that are greater than the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are greater than or equal to the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are less than the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are less than or equal to the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are greater than the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are greater than or equal to the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are less than the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are less than or equal to the provided iso8601 timestamp. The comparison is done using microsecond precision.
Domain of the accounts to fetch. Domains are unique and lowercase
Filters accounts by website. Multiple websites can be applied. An additional value of "_is_null" can be passed to filter accounts that do not have a website.
Filters accounts by archived_at status. Returns only accounts where archived_at is not null if this field is true. Returns only accounts where archived_at is null if this field is false. Do not pass this parameter to return both archived and unarchived accounts. This filter is not applied if any value other than "true" or "false" is passed.
Names of accounts to fetch. Name matches are exact and case insensitive. Multiple names can be fetched. Partial match is supported and applied when the "_starts_with" value is passed: v2/accounts?name[_starts_with]=value
Filters accounts by account_stage_id. Multiple account_stage_ids can be applied. An additional value of "_is_null" can be passed to filter accounts that do not have account_stage_id
Filters accounts by account_tier_id. Multiple account tier ids can be applied
Filters accounts by owner_id. Multiple owner_ids can be applied. An additional value of "_is_null" can be passed to filter accounts that are unowned
Filters accounts by whether the owner is active or not.
Returns all matching records that are greater than the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are greater than or equal to the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are less than the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are less than or equal to the provided iso8601 timestamp. The comparison is done using microsecond precision.
Filters by accounts matching all given custom fields. The custom field names are case-sensitive, but the provided values are case-insensitive. Example: v2/accounts?custom_fields[custom_field_name]=custom_field_value
Filters accounts by industry by exact match. Supports partial matching
Filters accounts by country by exact match. Supports partial matching
Filters accounts by state by exact match. Supports partial matching
Filters accounts by city by exact match. Supports partial matching
Filters accounts by owner_crm_id. Multiple owner_crm_ids can be applied. An additional value of "_is_null" can be passed to filter accounts that are unowned. A "_not_in" modifier can be used to exclude specific owner_crm_ids. Example: v2/accounts?owner_crm_id[_not_in]=id
Filters accounts by locale. Multiple locales are allowed
Filters by accounts matching all given user relationship fields, _is_null or _unmapped can be passed to filter accounts with null or unmapped user relationship values. Example: v2/accounts?user_relationships[name]=value
Key to sort on, must be one of: created_at, updated_at, last_contacted_at, account_stage, account_stage_name, account_tier, account_tier_name, name, counts_people. Defaults to updated_at
Direction to sort in, must be one of: ASC, DESC. Defaults to DESC
How many records to show per page in the range [1, 100]. Defaults to 25
The current page to fetch results from. Defaults to 1
Whether to include total_pages and total_count in the metadata. Defaults to false
Specifies whether the max limit of 10k records should be applied to pagination counts. Affects the total_count and total_pages data
Responses
- 200
Success
- application/json
- Schema
- Example (from schema)
Schema
ID of Account
Datetime of when the Account was created
Datetime of when the Account was last updated
Datetime of when the Account was archived, if archived
Account Full Name
Website domain, not a fully qualified URI
Conversational name of the Account
Description
Phone number without formatting
Website
Full LinkedIn url
Twitter handle, with @
Street name and number
City
State
Postal code
Country
Time locale
Industry
Type of the Account's company
Date or year of founding
Estimated revenue range
Estimated number of people in employment
CRM ID
CRM url
CRM object type
Mapped owner field from the CRM
Datetime this Account was last contacted
The type of the last touch to this Account. Can be call, email, other
Whether this company has opted out of communications. Do not contact someone at this company when this is set to true
Custom fields are defined by the user's team. Only fields with values are presented in the API.
Filters by accounts matching all given user relationship fields, _is_null or _unmapped can be passed to filter accounts with null or unmapped user relationship values
All tags applied to this Account
counts object
Number of people in SalesLoft associated with this Account
owner object
User that is marked as the owner of this Account
creator object
User that created this Account
last_contacted_by object
User that last contacted this Account
last_contacted_person object
Person who was last contacted at this Account
company_stage object
Company Stage that this Account has set. This is referred to as Account Stage in other parts of the API. When sorting by account_stage, the company stage's order is used
account_tier object
Account Tier that this Account has set
{
"id": 1,
"created_at": "2024-01-01T00:00:00.000000+00:00",
"updated_at": "2024-01-01T00:00:00.000000+00:00",
"archived_at": "2024-01-01T00:00:00.000000+00:00",
"name": "Hogwarts School of Witchcraft and Wizardry",
"domain": "salesloft.com",
"conversational_name": "Hogwarts",
"description": "British school of magic for students",
"phone": "+1 444 555 6666",
"website": "https://salesloft.com",
"linkedin_url": "https://www.linkedin.com/company/2296178/",
"twitter_handle": "@kyleporter",
"street": "4 Picket Drive",
"city": "Dufftown",
"state": "Mortlach",
"postal_code": "55555",
"country": "Scotland",
"locale": "Europe/London",
"industry": "Education",
"company_type": "Private",
"founded": "March 1st, 1820",
"revenue_range": "1,000,000-2,000,000",
"size": "1500",
"crm_id": "003i000001mnhpD",
"crm_url": "https://na15.salesforce.com/003i000001mnhpD",
"crm_object_type": "account",
"owner_crm_id": "003i000001mnhpD",
"last_contacted_at": "2024-01-01T00:00:00.000000+00:00",
"last_contacted_type": "call",
"do_not_contact": true,
"custom_fields": {
"MyField": "A Value",
"Other": "Field"
},
"user_relationships": {
"bff": "0037h00000d78aAAAQ",
"Other": "_is_null"
},
"tags": [
"7-23-2017",
"dreamforce"
],
"counts": {
"people": 15
},
"owner": {
"id": 1,
"_href": "https://api.salesloft.com/v2/users/1"
},
"creator": {
"id": 1,
"_href": "https://api.salesloft.com/v2/users/1"
},
"last_contacted_by": {
"id": 1,
"_href": "https://api.salesloft.com/v2/users/1"
},
"last_contacted_person": {
"id": 1,
"_href": "https://api.salesloft.com/v2/people/1"
},
"company_stage": {
"id": 1,
"_href": "https://api.salesloft.com/v2/account_stages/1"
},
"account_tier": {
"id": 1,
"_href": "https://api.salesloft.com/v2/account_tiers/1"
}
}