Actions56
- Objects Actions
- Attributes Actions
- List Attributes
- Create Attribute
- Get Attribute
- Update Attribute
- GET target/identifier/attributes/attribute/options
- POST target/identifier/attributes/attribute/options
- PATCH target/identifier/attributes/attribute/options/option
- GET target/identifier/attributes/attribute/statuses
- POST target/identifier/attributes/attribute/statuses
- PATCH target/identifier/attributes/attribute/statuses/status
- Records Actions
- Lists Actions
- Meta Actions
- Entries Actions
- Workspace Members Actions
- Notes Actions
- Tasks Actions
- Webhooks Actions
- Threads Actions
- Comments Actions
Records → List Records
AI-generatedOverview
This node operation lists records for a specified object in the Attio API. It allows users to retrieve a filtered, sorted, and paginated list of records from an object identified by a UUID or slug. This is useful for scenarios where you need to query and extract subsets of data from a database or CRM system, such as fetching contacts, leads, or any other entity records based on specific criteria.
Use Case Examples
- List all people records with the name 'Ada Lovelace' sorted by last name in ascending order, limiting the results to 500 records starting from the first record.
- Retrieve a subset of records from a custom object with specific filters and sorting applied.
Properties
| Name | Meaning |
|---|---|
| Object | A UUID or slug to identify the object to list records for. |
| Filter | A JSON object used to filter results to a subset of records based on specified criteria. |
| Sorts | A JSON array used to sort the results by specified attributes and directions. |
| Limit | The maximum number of results to return, with a default of 500. |
| Offset | The number of results to skip before returning, with a default of 0. |
Output
JSON
json- The JSON response containing the list of records returned by the API.
Dependencies
- Attio API access with an API key credential
Troubleshooting
- Ensure the 'Object' parameter is a valid UUID or slug identifying an existing object in Attio.
- Verify the JSON syntax in the 'Filter' and 'Sorts' fields to avoid parsing errors.
- Check API rate limits and authentication token validity if requests fail.
- Common error messages include 'Operation not found' if the operation or resource is misconfigured, and JSON parsing errors if filter or sort inputs are malformed.
Links
- Attio API Filtering and Sorting Guide - Detailed guide on how to use filtering and sorting in Attio API queries.
- Attio API Pagination Guide - Guide on how to use pagination parameters like limit and offset in Attio API.