Create Order

Description

Creates a DID Order.

Request

HTTP Method: POST

URI Path: /v3/orders

Body:

Name

Type

Is Required?

Description

allow_back_ordering

boolean

Optional

Allowing back ordering.

items

Array<CreateOrderItem>

Yes

Order items array.

Order Item:

Name

Type

Is Required?

Description

type

string

Optional

Item object type: did_order_items for DIDs and capacity_order_items for Channels.

attributes

One of DID Order Item Attributes ,
Capacity Order Item Attributes

Optional

Order Item Attributes object.

Order Item Attributes:

Name

Type

Is Required?

Description

sku_id

string

Yes

Stock Keeping Unit ID. Should be used with one of optional parameters qty, available_did_id or did_reservation_id.

qty

integer

Yes

Quantity of DIDs.

did_reservation_id

string

Optional

Specific DID Reservation ID.

billing_cycles_count

integer

Optional

The number of Billing Cycles that this DID Number will renew until expiration.

available_did_id

string

Optional

Specific Available DID ID.

Examples

http

POST /v3/orders HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]

{
  "data": {
    "type": "orders",
    "attributes": {
      "allow_back_ordering": true,
      "items": [
        {
          "type": "did_order_items",
          "attributes": {
            "qty": 15,
            "sku_id": "a78bb6d8-b05e-4e12-afe6-ad84ac979088"
          }
        }
      ]
    }
  }
}

curl

curl -i -X POST https://api.didww.com/v3/orders -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json" --data-raw '{"data": {"attributes": {"allow_back_ordering": true, "items": [{"type": "did_order_items", "attributes": {"qty": 15, "sku_id": "a78bb6d8-b05e-4e12-afe6-ad84ac979088"}}]}, "type": "orders"}}'

response

HTTP/1.1 201 Created
Content-Type: application/vnd.api+json

{
  "data": {
    "id": "9eeaab6c-b758-41b8-af86-8978a86603a2",
    "type": "orders",
    "attributes": {
      "reference": "FZH-374899",
      "amount": "79.2",
      "status": "Pending",
      "created_at": "2017-06-25T14:56:31.513Z",
      "description": "DID",
      "items": [
        {
          "type": "did_order_items",
          "attributes": {
            "qty": 15,
            "nrc": "5.00",
            "mrc": "5.00",
            "prorated_mrc": true,
            "billed_from": "2018-08-15",
            "billed_to": "2018-09-15",
            "did_group_id": "d01704b0-6522-47d5-8865-3398c417ed1d"
          }
        }
      ]
    }
  },
        "meta": {
          "api_version": "2017-09-18"
}

Other Responses

Code

Success

Description

404

No

Not Found

401

No

Unauthorized