Request 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 a-side partners requesting a Digital LOA. If you are an z-side partner creating a Digital LOA, see Request a Digital Letter of Authorization.
Prerequisites
-
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.
-
Get Possible Z-side Partners. Use the Get Possible Connections endpoint to retrieve the list of potential Z-side partners present in a given IBX data center.
Creating a Request - Known Z-side Partner
To create a request, send a POST
request to the /diloa/v1/digitalLoas/loaRequest
endpoint.
If the z-side partner you want to request this Digital LOA document from is listed in the response
to a GET request to the Get Possible Connections endpoint, set the provider.type
parameter to CUSTOMER_ORGANIZATION
, and provide their details.
POST /diloa/v1/digitalLoas/loaRequest | |
---|---|
Method | POST |
Endpoint | /diloa/v1/digitalLoas/loaRequest |
Headers | Authorization , Content-Type |
Path Parameters | Not applicable |
Query Parameters | Not applicable |
Body Parameters | ibx , requestedNumber , requestor , provider , notes |
Sample cURL request:
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas/loaRequest"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
"ibx": "CH1",
"requestedNumber": 2,
"requestor": {
"contacts": [
{
"type": "NOTIFICATION",
"registeredUser": "Registered",
"firstName": "John",
"lastName": "Smith",
"timezone": "Australia/Perth",
"availability": "ANYTIME",
"details": [
{
"note": "new email address",
"value": "kyle@mail.com",
"type": "EMAIL"
}
]
}
]
},
"provider": {
"type": "CUSTOMER_ORGANIZATION",
"orgIds": [
"123456"
],
"name": "Michael Scott Paper Company",
"contacts": [
{
"type": "NOTIFICATION",
"registeredUser": "Registered",
"firstName": "John",
"lastName": "Smith",
"timezone": "Australia/Perth",
"availability": "ANYTIME",
"details": [
{
"note": "new email address",
"value": "kyle@mail.com",
"type": "EMAIL"
}
]
}
]
},
"notes": "No additional notes"
}'
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.
Creating a Request - New Z-side Partner
To create a request, send a POST
request to the /diloa/v1/digitalLoas/loaRequest
endpoint.
Since the z-side partner 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 provider.type
parameter to NEW_RELATIONSHIP
. Also provide their contact information.
Sample cURL request:
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas/loaRequest"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
"ibx": "CH1",
"requestedNumber": 2,
"requestor": {
"contacts": [
{
"type": "NOTIFICATION",
"registeredUser": "Registered",
"firstName": "John",
"lastName": "Smith",
"timezone": "Australia/Perth",
"availability": "ANYTIME",
"details": [
{
"note": "new email address",
"value": "kyle@mail.com",
"type": "EMAIL"
}
]
}
]
},
"provider": {
"type": "NEW_RELATIONSHIP",
"email": "mike@mspc.us",
"name": "Michael Scott Paper Company"
},
"notes": "No additional notes"
}'
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.