POST /api/v1/phone_numbers
Purchase a new phone number using one of your existing provider configurations.

This endpoint supports multiple response formats. Pass serializer=name to retrieve data in an alternate format.

• Must be a value contained in the pick list:
  

  Acceptable Value	Description
  number	Default response format.
  number_grid	Modern response format that returns various foreign keys for use with other API endpoints.

Refer to the provider api for details

• Must be a valid foreign key reference to an Provider. Refer to: /api/docs/1.0/provider_configurations

Refer to the offer api for details

• Must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers

Purchase a toll-free or local number? true for toll-free, false for local number.

• Must be a boolean value: 1, true, yes, on, 0, false, no, off

The country where the number will be purchased.

• Must be one of: AR, AT, AU, BE, BG, BH, BR, CA, CH, CL, CN, CO, CY, CZ, DE, DK, DO, EE, ES, FI, FR, GB, GE, GR, HK, HR, HU, ID, IE, IL, IT, JP, KR, LT, LU, LV, MT, MX, MY, NL, NO, NZ, PA, PE, PH, PK, PL, PR, PT, RO, RU, SE, SG, SI, SK, SV, TR, US, ZA.

Refer to the traffic source api for details

• Must be a valid foreign key reference to an Traffic Source. Refer to: /api/docs/1.0/traffic_sources

Refer to the Number Pool api for details

• Must be a valid foreign key reference to an Number Pool. Refer to: /api/docs/1.0/ring_pools

Force Calls to Credit This Traffic Source and Extra Tokens, even if Lead Traffic Source or Data is Different

• Must be a boolean value: 1, true, yes, on, 0, false, no, off

Assign additional tokens that will be applied to leads and calls by passing a comma separated string of key:value pairs.

• Must be a valid list of tokens. Example tokens:
  buyer_interest:loan,another_token:value