Porting Numbers

Port existing phone numbers from your current provider to Audian with our Number Porting API.

Overview

Number porting allows you to transfer phone numbers from another telecommunications provider to Audian. The porting process typically takes 3-5 business days.

Initiate a Port

Start the porting process for a phone number.

Endpoint

POST https://api.audian.com:8443/v2/ports

Parameters

Parameter	Type	Required	Description
number	string	Yes	Phone number to port in E.164 format
account_number	string	Yes	Account number from current provider
account_pin	string	No	Account PIN/password from current provider
carrier_name	string	No	Current service provider name
billing_phone	string	Yes	Billing phone number on account
end_user_name	string	Yes	Name of the number's account holder
end_user_address	object	Yes	Address of the account holder

Address Object

{
  "street": "string",
  "city": "string",
  "state": "string",
  "postal_code": "string",
  "country": "string"
}

Request Example

curl -X POST 'https://api.audian.com:8443/v2/ports' \
  -H 'X-Auth-Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "number": "+14155551234",
    "account_number": "123456789",
    "carrier_name": "Previous Provider",
    "billing_phone": "+14155551234",
    "end_user_name": "John Doe",
    "end_user_address": {
      "street": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94102",
      "country": "US"
    }
  }'

Response

{
  "success": true,
  "data": {
    "id": "port_abc123",
    "number": "+14155551234",
    "status": "pending",
    "created_at": "2024-01-15T10:30:00Z",
    "estimated_completion": "2024-01-20T10:30:00Z",
    "carrier_status": "pending_transfer"
  }
}

Get Port Status

Check the status of a porting request.

Endpoint

GET https://api.audian.com:8443/v2/ports/{port_id}

Request Example

curl -X GET 'https://api.audian.com:8443/v2/ports/port_abc123' \
  -H 'X-Auth-Token: YOUR_API_KEY'

Response

{
  "success": true,
  "data": {
    "id": "port_abc123",
    "number": "+14155551234",
    "status": "completed",
    "created_at": "2024-01-15T10:30:00Z",
    "completed_at": "2024-01-18T10:30:00Z",
    "carrier_status": "ported",
    "messages": [
      "Number successfully transferred to Audian"
    ]
  }
}

Port Status Values

Status	Description
pending	Port request initiated, awaiting carrier confirmation
authorized	Carrier has authorized the port
in_progress	Port is being processed
completed	Number has been successfully ported
failed	Port request failed; check messages for details
cancelled	Port request was cancelled

List Ports

Retrieve all porting requests for your account.

Endpoint

GET https://api.audian.com:8443/v2/ports

Parameters

Parameter	Type	Required	Description
status	string	No	Filter by status
limit	integer	No	Maximum results (default: 20, max: 100)
offset	integer	No	Pagination offset

Requirements for Successful Porting

To successfully port a number:

1. Active Account: Number must be active with your current provider
2. Account Access: You must have access to the account information
3. No Pending Disputes: Account must have no outstanding disputes
4. Eligible Number: Number must be eligible for porting (most numbers are)
5. Regional Support: Audian must support porting in that region

Timeline

• Request Submission: Immediate
• Carrier Review: 1-2 business days
• Port Authorization: 2-3 business days
• Network Transfer: Typically completes within 4-6 hours after authorization
• Total: Usually 3-5 business days

Costs

Number porting is typically free or low-cost. Check your pricing plan for current rates.

Common Issues

Issue	Solution
Port rejected	Verify account information matches exactly
Carrier delay	Some carriers take longer; check status daily
Wrong account info	Cancel and resubmit with correct details
Number not eligible	Contact support; some specialized numbers can't be ported

Support

If your port has issues or takes longer than expected, contact Audian support with your port ID.