Get matches grouped by social network
GET/search/:searchId/matches
Returns all groups with first page of matches for each group. To load more matches for a specific group, use /search/{searchId}/matches/{source} endpoint.
Important: This endpoint is only available before matches are selected. Once matches are selected via POST /search/{searchId}/select, this endpoint returns 400 error. After selection, use GET /search/{searchId}/results to view selected match.
Request
Responses
- 200
- 400
- 401
- 404
- 409
- 500
- 503
Matches grouped by social network (first page for each group)
Bad request - matches already selected. Selection cannot be changed after credit is deducted.
Unauthorized
Not found
App-session guest pending outcome. GeneralError.message is guest_attempt_pending (retryable unfinished attempt) or session_transition_pending (retryable verified-account handoff). An unfinished attempt cannot create a second accepted Search. For authenticated multipart upload, 409 also covers an unfinished account attempt, a same-account/key collision between multipart and direct upload, or replay of a soft-deleted accepted Search. A deleted Search keeps its key consumed; the response discloses no deleted Search data and creates no new reservation. Pending attempts may be retried with the same key.
Response Headers
Seconds to wait before retrying a pending attempt or transition.
Internal server error
Canonical session identity, transaction or admission storage unavailable. Guest requests fail closed instead of receiving a new session or quota. For authenticated multipart upload, infrastructure failure or an uncertain admission outcome also returns 503. Retry with the same account and Idempotency-Key; uncertainty must not create a second accepted Search.