Route checks

Places one short real call over each route (1 to 3, in your order: the first is your primary, the rest backups) and reports whether it works. Returns 202 with a checkId at once; poll GET /routes/check/{checkId}.

- network (default): the call goes to a public line that answers by itself (a speaking clock or information line) in the destination, chosen from the ones the route's rates cover and, where we have one, of the same line type as number (mobile or fixed). The call is answered, held about two seconds and ended. Where no such line exists yet for a destination, a lighter check runs instead: it confirms only that the route accepts calls, places no call to anyone, and says so (accepts). - ring_me: the route calls number, which must be your own phone in a country the route serves. Ringing counts as working. Satellite and premium-rate ranges are refused; one number can be rung by checks 3 times an hour, and an account can ring 3 different numbers a day (429).

number (network mode) narrows the check to a destination: a dial code (92) or a full number (+923001234567); for an A-Z rate sheet pass it, or the route's own country is used.

Billing: each connected leg is charged at the route's rate (your own effective rate for that number) for the billable seconds, plus the normal platform fee, from your test credit first and then your balance (paidFrom says which). Unanswered legs and suspected false answers cost nothing; a check of your own listing is free. A funded balance is required (400 otherwise). Limits: 10 checks a minute and 60 an hour per account (429); when the limiter cannot be reached checks pause (503) rather than run unlimited. Send X-Idempotency-Key to make a retry safe: the retry returns the first check instead of placing a second. Blended routes cannot be checked yet (400). A test key returns a simulated result immediately: no call, no charge.

You may check routes you have not bought. Private routes need an access grant.

Sends ONE short fixed message over exactly this SMS listing (never Smart Routing) to your own mobile, by the same transport a real message uses, and reports what happened. Returns 202 with a checkId at once; poll GET /routes/check/{checkId} (the test is its only route). The text is fixed and so is the sender: "PacketExchange test message: this route delivered to your phone. Ref K7QD", from a platform sender chosen by the route's sender rules (numeric on a route that carries numeric senders only).

Results: accepted (the route took it; no carrier receipt yet), delivered (a carrier receipt confirmed it) or refused (the route refused it, or the receipt said it failed; errorCode says which). Receipts usually arrive within a minute; on a route that returns none the test stays accepted, and routeReturnsReceipts says whether the route has returned any lately. A later receipt updates the test, so it also appears in GET /routes/checks.

number must be a mobile in international format that the route covers (by its rate sheet or its prefixes, longest prefix first); a number it does not cover is refused (400), as are premium-rate, satellite, special-service and short-code ranges, embargoed destinations and numbers on your Do-Not-Contact list.

Billing: the route's normal price for one message for that number (your own effective rate), plus the normal platform fee, from your test credit first and then your balance (paidFrom). A message the route refuses is not charged, and one whose receipt says it failed is refunded. Testing your own listing is free. Limits: 3 test messages to one number an hour (across all accounts), 5 different numbers and 20 test messages per account a day (429); when the limiter cannot be reached tests pause (503). Send X-Idempotency-Key to make a retry safe. A test key returns a simulated result at once: nothing is sent and nothing is charged.

Test messages never count in SMS volume, revenue or quality figures. A buyer's delivered test counts as working and a refused one as a failure on the listing's check health, which the seller sees without learning who ran it.

For each route (1 to 3), whether we have a registered public test line for its destination (or for number's destination on an A-Z rate sheet). When there is none, check the route with mode: ring_me and your own number. Says yes or no only.

Per-route verdicts, in your order. message is the sentence to show a person. Routes are named without seller details.

Buys every route in the check that came back working, in your order, and puts them at the top of your routing order: the first is the primary, the rest its backups (your other ranked routes keep their relative order below them). Routes you already bought are reused. A route that cannot be bought (for example email not verified, a private route, or a US route that needs compliance review) is reported in purchases[].error and does not stop the others. Needs a live key.

For your own listing: the last 24 hours of full route checks (working vs failed), the recent checks, and any suspension made by checks with its reason and evidence. A listing whose checks fail 10 or more times in 24 hours with none working is confirmed once more and then suspended from the marketplace; run POST /routes/check with its id (free for your own listing) after fixing it, and a working result puts it back. A call answered under 1.5 s after our INVITE (or under 2.5 s with no ringing) is a false answer and counts as a failure; answerMs is the evidence. Your own checks, checks to a buyer's own number (ring_me) and lighter checks never count. On an SMS listing the window counts buyers' test messages instead: delivered is working, refused is a failure, a message still awaiting a receipt does not count, and an SMS listing is never suspended automatically.