Attio icon

Attio

Interact with Attio API

Records → List Records

AI-generated

Overview

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

  1. 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.
  2. 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

Discussion