Virtual number

Your workspace's dedicated virtual number - the number recipients reply to. Always returns 200: when the workspace has no active number, active is false and the other fields are null, so integrations can branch without handling errors. Activating or releasing a number is done in the Sendy app (מספר וירטואלי), not via the API.

curl https://sendy.co.il/api/v1/number -H "Authorization: Bearer sk_live_8Jc…"

const res = await fetch(`https://sendy.co.il/api/v1/number`, {
  headers: { Authorization: "Bearer sk_live_8Jc…" },
});
const number = await res.json();

{
  "active": true,
  "number": "+972531234567",
  "local_number": "0531234567",
  "assigned_at": "2026-08-20T07:00:00.000Z",
  "next_renewal_at": "2026-09-20T06:00:00.000Z",
  "grace_until": null
}

number matches the sender value in List senders - an active virtual number is automatically an approved from for sending. next_renewal_at is the next monthly renewal charge; grace_until is set only when the last renewal failed and the number will be released at that time unless credits are topped up.