Create a Match ALL Request

get

https://{yourAccountName}.api-us1.com/api/3/segmentMatchAll/{segmentId}

A new match-all request will be initiated. If results are not ready within 4 seconds, a response that lacks a result-set will be returned and the response's is_ready attribute will be equal to false. Use the returned segmentId and runId to poll and check back later to see if the result-set is ready

Path Params

segmentId

string

required

A segment id

Query Params

sort

string

enum

Defaults to id

Comma delimited list of fields for which to sort the results. Optionally prepended with a dash sign to indicate descending order. Allowed fields: id, email, phone, first_name, last_name, full_name, cdate, udate, account_name, score, score. The score option will sort off of the value of a particular score.

Examples: "email", "-phone", "score2", "last_name,-first_name"

page

integer

Defaults to 1

Page Number

page_size

integer

≤ 10000

Defaults to 20

Page Size. Maximum: 10,000

instant

string

enum

If present, API will return instantly with a runId without waiting for up to 4 seconds for the results to be ready. Useful if you want to kick off a match-all request but don't need the results immediately

Allowed:

Responses

401

Unauthorized

403

Forbidden

Language

URL

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Segment match all request started and/or completed

400Bad Request

404Segment not found