List Verifications

Search verification history and continue through matching results.

GEThttps://api.maileroo.com/v1/verify/verifications

List the account's verification history. Results are ordered newest first and retained for 120 days.

Scope: verify.verifications.read

Query Parameters

statusstringoptional

Filter by pending, sent, verified, expired, failed, or cancelled.

channelstringoptional

Filter by sms, voice, whatsapp, telegram, or email.

sender_profile_idstringoptional

Filter by sender profile ID.

tostringoptional

Filter by destination.

countrystringoptional

Filter by destination country code.

created_afterstringoptional

Include results created at or after this RFC3339 timestamp.

created_beforestringoptional

Include results created before this RFC3339 timestamp.

idsstringoptional

Comma-separated verification IDs. Pass at most 100 distinct IDs.

limitintegeroptional

Results per page. Defaults to 50 and is capped at 100. If ids is supplied without limit, all matching IDs are returned on one page.

cursorstringoptional

Pass the next_cursor value from the previous response to continue. Omit it for the first page.

Sample Request

Request

curl "https://api.maileroo.com/v1/verify/verifications?status=verified&channel=sms&created_after=2025-01-01T00%3A00%3A00Z&limit=50" \
  -H "Authorization: Bearer roo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Sample Response

List data is returned under data.items. next_cursor is null when there is no next page.

Response

{
  "data": {
    "items": [
      {
        "id": "vrf_0123456789abcdef01234567",
        "account_id": "12345",
        "sender_profile_id": "prf_0123456789abcdef01234567",
        "channel": "sms",
        "to": "+61412345678",
        "country": "AU",
        "code_length": 6,
        "status": "verified",
        "attempts": 1,
        "max_attempts": 3,
        "created_at": "2025-01-01T12:00:00Z",
        "expires_at": "2025-01-01T12:15:00Z",
        "verified_at": "2025-01-01T12:02:00Z"
      }
    ],
    "next_cursor": null,
    "total": 1
  }
}

List rows omit updated_at and the verification code. total is the number of retained results matching the filters, independent of the current page.

Errors

Common authentication, rate-limit, and service-availability errors are described in the Introduction. This endpoint can also return:

400 Bad Request — an invalid status, channel, timestamp, cursor, or more than 100 distinct IDs.

PreviousCheck Next Get