List Experiences

Changed on

Returns a paginated list of Experience summaries filtered by query parameters.

Supports Cursor-based pagination via the cursor parameter. Use the cursor value from the previous response to retrieve the next page.

Supports conditional requests via the If-None-Match header. If the provided ETag matches, returns 304 Not Modified with no body.

Filters (OR semantics within each): languages, channel, createdAtFrom, createdAtTo.

Backward compatibility: New optional fields may be added to items in the response at any time. Clients must tolerate unknown properties.

Rate limit: 20 requests per minute per organization.

get/experiences

Request

  • Base URL: https://genstudio.adobe.io
  • URL: https://genstudio.adobe.io/experiences
  • Auth: one of:
    • OAuth 2 (client credentials, token URL https://ims-na1.adobelogin.com/ims/token/v3)
    • API key in header x-api-key

Query parameters

string
OR
string[]

BCP 47 language tag to filter by, exact match (case-insensitive)

'email' | 'meta' | 'meta_organic' | 'display' | 'ctv' | 'linkedin' | 'linkedin_organic' | 'tiktok' | 'chatgpt' | 'youtube'
OR
ChannelInput[]

Filter by channel. Accepted values: email, meta, meta_organic, display, ctv, linkedin, linkedin_organic, tiktok, chatgpt, youtube. Unknown values return 400.

createdAtFromstring date-time
Example:2026-01-01T00:00:00.000Z

Inclusive lower bound (ISO 8601) on createdAt.

createdAtTostring date-time
Example:2026-12-31T23:59:59.000Z

Exclusive upper bound (ISO 8601) on createdAt. Must be strictly greater than createdAtFrom.

limitinteger
Example:25

Maximum number of items per page (1–50).

cursorstring
Example:eyJsYXN0SWQiOiJ1cm46YWFpZDphZW0ifQ

Opaque cursor from the previous response's cursor field.

Headers

authorizationstring required
Example:Bearer eyJhbGciOiJSUz...

Bearer token from Adobe OAuth Server-to-Server credentials.

x-api-keystring required
Example:37e7532f1c5a225acf8d2fad131cde8d

Client ID from the Adobe Developer Console project.

x-ims-org-idstring required
Example:36031A56669DEACD0A49402F@AdobeOrg

IMS Organization ID (format: {HEX}@AdobeOrg). Found in Adobe Developer Console (open your project, then Credentials → OAuth Server-to-Server → Credential Details → Organization ID).

x-request-idstring
Example:550e8400-e29b-41d4-a716-446655440000

Client-generated UUID for request tracing.

x-correlation-idstring
Example:corr-abc-123

Correlation ID to group related requests.

x-adobe-accept-experimental'1' required
Example:1

Required opt-in header for experimental API endpoints. Must be set to "1". Requests without this header will receive a 400 Bad Request response.

Response

Paginated list of Experience summaries

cursorstring

Changes

  • a85941f3568eRevision changes
    • breaking

      added the pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to the query request parameter createdAtFrom

    • breaking

      added the pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to the query request parameter createdAtTo

    • breaking

      the // response's property type changed from string to no type for status

    • info

      added to the // response property allOf list for the response status

    • info

      removed the chatgpt enum value from the // response property for the response status

    • info

      removed the ctv enum value from the // response property for the response status

    • info

      removed the display enum value from the // response property for the response status

    • info

      removed the email enum value from the // response property for the response status

    • info

      removed the linkedin enum value from the // response property for the response status

    • info

      removed the linkedin_organic enum value from the // response property for the response status

    • info

      removed the meta enum value from the // response property for the response status

    • info

      removed the meta_organic enum value from the // response property for the response status

    • info

      removed the tiktok enum value from the // response property for the response status

    • info

      removed the youtube enum value from the // response property for the response status

    • info

      the // response's property pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ was added for the status

    • info

      the // response's property pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ was added for the status

  • fa6506f1f842Revision changes
    • breaking

      added the new required header request parameter x-adobe-accept-experimental

    • breaking

      the // response's property type changed from no type to string for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      deleted the query request parameter language

    • warning

      added the new chatgpt enum value to the // response property for the response status

    • warning

      added the new ctv enum value to the // response property for the response status

    • warning

      added the new display enum value to the // response property for the response status

    • warning

      added the new email enum value to the // response property for the response status

    • warning

      added the new linkedin enum value to the // response property for the response status

    • warning

      added the new linkedin_organic enum value to the // response property for the response status

    • warning

      added the new meta enum value to the // response property for the response status

    • warning

      added the new meta_organic enum value to the // response property for the response status

    • warning

      added the new tiktok enum value to the // response property for the response status

    • warning

      added the new youtube enum value to the // response property for the response status

    • info

      added the new optional query request parameter languages

    • info

      removed subschema #2 from the // response property anyOf list for the response status

    • info

      added the required property // to the response with the status