create_match_all_request
Read-onlyIdempotent
Initiate a match-all request to find all contacts matching a segment. Results are returned within seconds, or a run ID is provided for later polling.
Instructions
🟢 READ-ONLY · query · Segments · POST /api/3/segmentMatchAll
Create a Match All Request for a new Segment
Runs a search/report (a POST that returns data). Changes no account records; may create a short-lived, cached result-set.
Find all Contact Id's that match the given Segment. The provided segment will be saved with a 24 hour TTL. 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. Use the returned segmentId and runId to poll and check back later to see if the result-set is ready.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Request body (application/json). | |
| page | No | Page Number | 1 |
| sort | No | 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<score-id>, field<custom-field-id>. The score<score-id> option will sort off of the value of a particular score. The field<custom-field-id> option will sort off of the value of a particular custom field. | id |
| instant | No | 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 | |
| page_size | No | Page Size. Maximum: 10,000 | 20 |