---
title: "Available number and phone numbers resources"
description: "<p>Retrieve an available number; list and update numbers; start and get reputation audits.</p>\n<h2 id=\"how-it-works\">How it works</h2>\n<p>Retrieve an available number; list and update numbers; start and get reputation au"
---

> Documentation Index
> Fetch the complete documentation index at: https://help.messages.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Available number and phone numbers resources

<p>Retrieve an available number; list and update numbers; start and get reputation audits.</p>
<h2 id="how-it-works">How it works</h2>
<p>Retrieve an available number; list and update numbers; start and get reputation audits. Messages.org keeps channel-specific behavior explicit while providing stable identifiers, safe retries, and auditable lifecycle events.</p>
<h2 id="set-it-up">Set it up</h2>
<ol>
<li>Authenticate with a project key scoped to the intended environment and resource.</li>
<li>Validate identifiers, fields, channel capability, and consent before the request.</li>
<li>Persist resource IDs and reconcile asynchronous state from signed events.</li>
</ol>
<h2 id="what-to-expect">What to expect</h2>
<ul>
<li>The operation is traceable by stable request and resource identifiers.</li>
<li>Acceptance, provider delivery, and customer interaction remain separate states.</li>
<li>Retries and reordered events do not duplicate the customer action.</li>
</ul>
<blockquote>
<p>[!TIP] Keep API keys, signing secrets, customer addresses, and message bodies out of source and logs.</p>
</blockquote>

Source: https://help.messages.org/api-imessage/available-number-and-phone-numbers-resources/index.mdx