📘

Closed Beta

Identity Envelope Creation via API is not yet generally available. If you're interesting in participating in the beta test, contact your LiveRamp representative.

You use identity envelopes for security when transmitting RampIDs and their associated metadata. Each envelope is encrypted with a unique client-specific encryption key. An envelope is valid for 15 days from the date of creation.

Unsuccessful responses from the endpoint may return status codes of 400 (bad request), 404 (not found), or 500 (server error). See the error codes listed in Error documents for more information.

Example Batch Call to Create Identity Envelopes

1. Create a JSON file to contain the RampIDs you want envelopes for.
   JSON

   [
     "/people/anonymousAbilitec/{RampId1}",
     "/people/anonymousAbilitec/{RampId2}",
     …
   ]

2. Make a POST call to https://us.am.identity.api.liveramp.com/v1/batch/lookup:
   cURL

   curl --request POST \
        --url https://us.am.identity.api.liveramp.com/v1/batch/lookup/ \
        --header 'accept: application/json' \
        --header 'content-type: application/json'
        --data 'JSON DATA HERE'

📘

Pseudonymous Identifier

In the context of the RampID API, references to "anonymousAbilitec" indicate resolving to people-based pseudonymous online identifiers. For more information, see "RampID Methodology" in the Identity documentation.