The Retrieval API Developer Hub

The Retrieval API allows you to match your data to the LiveRamp Identity Graph and receive RampIDs. API calls are made using batch request calls that contain up to 1000 records per call.

Guides    API Reference

Group Documents

A group document is returned when the limit parameter in a request to the Match endpoint or Lookup endpoint is set to a value greater than "1" and there are more than one matches. The group document will contain a number of documents equal to the number of matches.

Documents are returned in the order they were matched with the best match listed first.

The maximum number of documents contained in a group document is 10. Sometimes the number of documents that match the input is less than the limit especially when the limit is set close to 10.

The limit parameter does not impact the requirements for a record to become a match; it only allows additional matches to be returned if they exist. Each document inside the group document is counted as a transaction.

Updated 3 months ago

Group Documents


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.