Skip to main content

Create a Digital LOA

Digital Letter of Authorization (LOA) enables convenient ordering of services that require third-party authorization. It minimizes the engagement from both A-side and Z-side when processing orders for interconnection services such as Cross Connect.

This document is for z-side partners creating a Digital LOA. If you are an a-side partner seeking a Digital LOA from a z-side partner, see Request a Digital Letter of Authorization.

Prerequisites

  1. Authenticate - Submit your user credentials, Client ID, and Client Secret for OAuth2 authentication. Refer to API Authentication for instructions on how to call the OAuth API to validate and authenticate your credentials.

  2. (Optional) Get Possible A-side Partners. Use the Get Possible Connections endpoint to retrieve the list of A-side partners that are present in a specified IBX data center.

Creating a Digital LOA - Existing A-side Relationship

To create a Digital LOA send a POST request to the /diloa/v1/digitalLoas endpoint. Specify the a-side partner and connection details in the body of the request.

POST /diloa/v1/digitalLoas
MethodPOST
Endpoint/diloa/v1/digitalLoas
HeadersAuthorization, Content-Type
Path ParametersNot applicable
Query ParametersNot applicable
Body Parameterstype, crossConnect, serviceTypeName, mediaTypeName, aSide, connectorTypeName, circuitId, patchPanel, number, portA, PortB, zSide, requestor, provider, contacts, registeredUser, firstName, lastName, timezone, availability, details, note, value, notes, expiryDateTime

If the A-side customer you want to issue this Digital LOA document to is listed in the response to a GET request to the Get Possible Connections endpoint, set the requestor.type parameter to CUSTOMER_ORGANIZATION.

In the requestor.ids parameter, specify customer organizations entitled to use this Digital LOA document.

Sample cURL Request:

curl -X  
POST "https://api.equinix.com/diloa/v1/digitalLoas"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
    "products": [
        {
            "type": "CROSS_CONNECT",
            "crossConnect": {
                "connectionService": "UTP",
                "mediaType": "CAT6",
                "protocolType": "ETHERNET",
                "zSide": {
                    "connectorType": "RJ45",
                    "patchPanelId": "PP:0000:6256843",
                    "circuitId": "34234535",
                    "portA": 4
                }
            }
        }
    ],
    "requestor": {
        "type": "CUSTOMER_ORGANIZATION",
        "contacts": [
            {
                "type": "NOTIFICATION",
                "details": [
                    {
                        "value": "jane@xyz.com",
                        "type": "EMAIL"
                    }
                ]
            }
        ],
        "orgIds": [
            "123412",
            "223124"
        ],
        "name": "XYZ Company"
    },
    "provider": {
        "contacts": [
            {
                "type": "NOTIFICATION",
                "firstName": "John",
                "lastName": "Smith",
                "timezone": "America/Los_Angeles",
                "details": [
                    {
                        "value": "john@smith.com",
                        "type": "EMAIL"
                    }
                ]
            }
        ]
    },
    "notes": "",
    "expiryDateTime": "2022-07-31T21:59:59.999Z"
}'

The parameters included in the request body are specific to this example. For a full list of parameters and their descriptions, see the API Reference.

Sample Response:

{  
    "token": "<token>",
    "uuid": "079dc798-05e8-11ed-b939-0242ac120002",
    "state": "READY_FOR_USE",
    "draft": false,
    "changeLog": {
        "createdDateTime": 2018-05-24T18:19:59.999Z
    },
    "link": {
        "rel": "info",
        "href": "https://ic-core-prod-ingress-usw1.clouda.equinix.com:80/diloa/v2/digitalLoas/402cbf99-97d7-440f-8291-1a4b9639154a",
        "method": "GET",
        "contentType": "application/json",
        "authenticate": true
    },
    "expiryDateTime": 2018-06-24T18:19:59.999Z,
    "href": "diloa/v1/digitalLoas/079dc798-05e8-11ed-b939-0242ac120002"
}

Response payload includes configuration parameters defined in the request body. For a full list of possible parameters and their descriptions, see the API Reference.

Creating a Digital LOA - New A-side Relationship

To create a Digital LOA send a POST request to the /diloa/v1/digitalLoas endpoint. Specify connection details in the body of the request.

Since the A-side customer you want to issue this Digital LOA document to isn't listed in the response to a GET request to the Get Possible Connections endpoint, set the requestor.type parameter to NEW_RELATIONSHIP. Also provide their contact information.

Sample cURL Request:

curl -X  
POST "https://api.equinix.com/diloa/v1/digitalLoas"
-H "content-type: application/json"
-H "Authorization: Bearer {Access Token}"
-d '{
    "products": [
        {
            "type": "CROSS_CONNECT",
            "crossConnect": {
                "connectionService": "UTP",
                "mediaType": "CAT6",
                "protocolType": "ETHERNET",
                "zSide": {
                    "connectorType": "RJ45",
                    "patchPanelId": "PP:0000:6256843",
                    "circuitId": "34234535",
                    "portA": 4
                }
            }
        }
    ],
    "requestor": {
        "type": "NEW_RELATIONSHIP",
        "email": "jane@xyz.com",
        "name": "XYZ Company"
    },
    "provider": {
        "contacts": [
            {
                "type": "NOTIFICATION",
                "firstName": "John",
                "lastName": "Smith",
                "timezone": "America/Los_Angeles",
                "details": [
                    {
                        "value": "john@smith.com",
                        "type": "EMAIL"
                    }
                ]
            }
        ]
    },
    "notes": "",
    "expiryDateTime": "2022-07-31T21:59:59.999Z"
}'

The parameters included in the request body are specific to this example. For a full list of parameters and their descriptions, see the API Reference.

Authorize Digital LOA Use

This step is applicable to new A-side customer relationships. After the Digital LOA document is created, the A-side party receives an email notification with authorization link.

Once the A-side party verifies and approves the Digital LOA document, send a GET request to the /diloa/v1/digitalLoas/{id}/actions endpoint. Specify the Digital LOA in the path of the request and the type as AUTHORIZE in the body of the request.

POST /diloa/v1/digitalLoas/{uuid}/actions
MethodPOST
Endpoint/diloa/v1/digitalLoas/{uuid}/actions
HeadersAuthorization, Content-Type
Path Parametersuuid
Query ParametersNot applicable
Body Parameterstype

Sample cURL Request:

curl -X  
POST "https://api.equinix.com/diloa/v1/digitalLoas/{id}/actions"
-H "Authorization: Bearer <token>"
-d '{
    "type": "AUTHORIZE"
}'

The parameters included in the request body are specific to this example. For a full list of parameters and their descriptions, see the API Reference.

Monitoring Digital LOA Status

Use the /diloa/v1/digitalLoas/{id} API request to monitor LOA document's status. For information on possible statuses, see .