Skip to main content

Effective 10 September 2024, API Documentation can be found on our Equinix Product Documentation site.
The content on this page will not be updated after 1 Oct 2024 and will be inaccessible after 31st Dec 2024.


403: Forbidden

The 403 (Forbidden) status code indicates that the server cannot authorize the requested resource.

Code403
DescriptionForbidden resource.
Generic CauseInsufficient permission to access the resource.
Quick FixVerify end-point URL, resource information, or authorization credentials.

EQ-2010005

CodeEQ-2010005
DescriptionQuoteID not found for this account. Please ensure you have the appropriate permissions to view this quote.
Generic CauseUser is not permitted to access the quote.
Quick FixVerify quote ID submitted.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQ-2010005"
MESSAGE: "QuoteID not found for this account. Please ensure you have the appropriate permissions to view this quote"
 

Verify quote ID submitted, and modify the value accordingly. If problem persists, contact your Master Administrator for permission information.

The quote ID is incorrect. Replace the ID with the correct value.

curl -X
GET "https://api.equinix.com/v2/quotes/1-2031234567"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"

EQ-2012006

CodeEQ-2012006
DescriptionPermission denied to create. Please ensure you have appropriate permissions.
Generic CauseUser is not permitted to access the end-point URL and resource information.
Quick FixVerify authorization credentials.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQ-2012006"
MESSAGE: "Permission denied to create. Please ensure you have appropriate permissions"
 

Verify authorization credentials is for the authenticated user with required permission, and modify this value accordingly. Contact your Master Administrator for permission information.

The bearer token is incorrect. Replace the token with the correct value.

curl -X 
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"
-d '{
"details": [
{
"aSide": {
"connectionService": "Multi-Mode Fiber",
"mediaType": "50_MICRON_MULTI-MODE_FIBER_OM3",
"protocolType": "10_GIG_ETHERNET",
"connectorType": "ST",
"patchPanel": {
"id": "PP:0101:1234567"
}
},
"zSide": {
"connectorType": "SC",
"connectionService": "Multi-Mode Fiber",
"circuitId": "1-23123123",
"patchPanel": {
"id": "PP:0101:1010101"
}
}
}
]
}

EQ-2012007

CodeEQ-2012007
DescriptionPermission denied to update or cancel. Please ensure you have appropriate permissions
Generic CauseUser is not permitted to access the end-point URL and resource information.
Quick FixVerify resource information passed in the URL.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQ-2012007"
MESSAGE: "Permission denied to update or cancel. Please ensure you have appropriate permissions"
 

Verify order ID passed in the URL, and modify this value accordingly. If problem persists, contact your Master Administrator for permission information.

The order ID is incorrect. Replace the ID with the correct value.

curl -X 
PATCH "https://api.equinix.com/colocations/v2/orders/crossConnects/1-2031234567"
-H "Content-type: application/json"
-H "Authorization: "Bearer wwErtY8zyW1abcdefGHI"
-d '{
"contacts": [
{
"registeredUser": [
"johndoe1",
"janesmith2"
],
"type": "NOTIFICATION"
}
]
}'

EQ-2014005

CodeEQ-2014005
DescriptionUnable to access or locate given order. Please ensure you have appropriate permissions.
Generic CauseUser is not permitted to access the order.
Quick FixVerify order ID passed in the URL.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQ-2014005"
MESSAGE: "Unable to access or locate given order. Please ensure you have appropriate permissions."
 

Verify order ID and modify the value accordingly. If problem persists, contact your Master Administrator for permission information.

The order ID is incorrect. Replace the ID with the correct value.

curl -X 
GET "https://api.equinix.com/colocations/v2/orders/1-2031234567"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"

EQ-2014007

CodeEQ-2014007
DescriptionPermission denied to update or cancel. Please ensure you have appropriate permissions.
Generic CauseUser is not permitted to access the end-point URL and resource information.
Quick FixVerify authorization credentials.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQ-2014007"
MESSAGE: "Permission denied to update or cancel. Please ensure you have appropriate permissions."
 

Verify authorization credential is for the authenticated user with required permission, and modify this value accordingly. Contact your Master Administrator for permission information.

The bearer token is incorrect. Replace the token with the correct value.

curl -X
POST "https://api.equinix.com/colocations/v2/orders/1-203123456789/cancel"
-H "content-type: application/json"
-H "authorization: Bearer qwErtY8zyW1abcdefGHI"
-d '{
"reason": "This was duplicated.",
}'

EQ-2016005

CodeEQ-2016005
DescriptionUnable to access or locate given shipment. Please ensure you have appropriate permissions.
Generic CauseUser is not permitted to access the end-point URL and resource information.
Quick FixVerify resource information passed in the URL.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQ-2016005"
MESSAGE: "Unable to access or locate given shipment. Please ensure you have appropriate permissions."
 

Verify order ID passed in the URL, and modify this value accordingly. If problem persists, contact your Master Administrator for permission information.

The order ID is incorrect. Replace the ID with the correct value.

curl -X
PATCH "https://api.equinix.com/colocations/v2/orders/shipments/1-20312345678"
-H "content-type: application/json"
-H "authorization: Bearer qwErtY8zyW1abcdefGHI"
-d '{
"cageDelivery": true,
},
"requestedDateTime": "2020-11-02T10:45:41Z"
}

EQ-2016006

CodeEQ-2016006
DescriptionPermission denied to create. Please ensure you have appropriate permissions.
Generic CauseUser is not permitted to access the end-point URL and resource information.
Quick FixVerify resource information passed in the URL.
ERROR SCENARIO EXAMPLE
ERROR CODE:       "EQ-2016006"
MESSAGE: "Permission denied to create. Please ensure you have appropriate permissions."
ADDITIONAL INFO:
[
{
"property": "details.cages[]",
"reason": "details.cages[].id or details.cages[].cabinetId or details.cages[].accountNumber is not found",
"value": [
{
"id": "AM1:01:000111"
}
]
}
]
 

Verify cage ID passed, and modify this value accordingly. If problem persists, contact your Master Administrator for permission information.

The cage ID is incorrect. Replace the ID with the correct value.

curl -X
POST "https://api.equinix.com/colocations/v2/orders/workVisits"
-H "content-type: application/json"
-H "authorization: Bearer qwErtY8zyW1abcdefGHI"
-d '{
"details": {
"cages": [
{
"id": "AM1:01:000111"
}
],
"visitStartDateTime": "2020-11-02T10:45:41.564Z",
"visitEndDateTime": "2020-11-04T10:45:41.564Z",
"visitors": [
{
"registeredUsers": [
"johndoe123"
]
}
]
}
}'

EQ-2016007

CodeEQ-2016007
DescriptionPermission denied to update or cancel. Please ensure you have appropriate permissions.
Generic CauseUser is not permitted to access the end-point URL and resource information.
Quick FixVerify resource information passed in the URL.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQ-2016007"
MESSAGE: "Permission denied to update or cancel. Please ensure you have appropriate permissions."
 

Verify order ID passed in the URL, and modify this value accordingly. If problem persists, contact your Master Administrator for permission information.

The order ID is incorrect. Replace the ID with the correct value.

curl -X
PATCH "https://api.equinix.com/colocations/v2/orders/workVisits/1-20312345678"
-H "content-type: application/json"
-H "authorization: Bearer qwErtY8zyW1abcdefGHI"
-d '{
"details": {
"visitStartDateTime": "2020-11-02T10:45:41.564Z"
}
}'

EQ-2021005

CodeEQ-2021005
DescriptionUsername not found for this account. Please ensure you have the appropriate permissions to view this user.
Generic CauseUser is not permitted to access the user profile.
Quick FixVerify username passed in the URL.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQ-2021005"
MESSAGE: "Username not found for this account. Please ensure you have the appropriate permissions to view this user"
 

Verify username and modify the value accordingly. If problem persists, contact your Master Administrator for permission information.

The username is incorrect. Replace the username with the correct value.

curl -X 
GET "https://api.equinix.com/access/v2/users/username1"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"

EQ-2021006

CodeEQ-2021006
DescriptionPermission denied to create. Please ensure you have appropriate permissions.
Generic CauseUser is not permitted to access the end-point URL and resource information.
Quick FixVerify authorization credentials.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQ-2021006"
MESSAGE: "Permission denied to create. Please ensure you have appropriate permissions."
 

Verify authorization credentials is for the authenticated user with required permission, and modify this value accordingly. Contact your Master Administrator for permission information.

The bearer token is incorrect. Replace the token with the correct value.

curl -X 
POST "https://api.equinix.com/access/v2/users"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"
-d {
"firstName": "John",
"lastName": "Doe",
"companyName": "Sample Company",
"contactDetails": [
{
"type": "PHONE",
"value": "+81-111-111-1111"
},
{
"type": "EMAIL",
"value": "example@email.com"
}
],
"deactivationDateTime": "2021-02-T01:10:11.355Z"
}

EQ-2021007

CodeEQ-2021007
DescriptionUsername not found for this account. Please ensure you have the appropriate permissions to update this user.
Generic CauseUser is not permitted to access the user profile.
Quick FixVerify username passed in the URL.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQ-2021007"
MESSAGE: "Username not found for this account. Please ensure you have the appropriate permissions to update this user"
 

Verify username and modify the value accordingly. If problem persists, contact your Master Administrator for permission information.

The username is incorrect. Replace the username with the correct value.

curl -X 
PATCH "https://api.equinix.com/access/v2/users/username1"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"
-d '{
"contactDetails": [
{
"type": "PHONE",
"value": "+81-111-111-1111"
},
{
"type": "EMAIL",
"value": "example@email.com"
}
]
}

EQ-2061005

CodeEQ-2061005
DescriptionUnable to access or locate given parameter. Please ensure you have appropriate permissions.
Generic CauseUser is not permitted to access parameters.
Quick FixVerify end-point URL and resource information. Refer to 'Additional Info' for more details.
ERROR SCENARIO EXAMPLE
ERROR CODE:       "EQ-2061005"
MESSAGE: "Unable to access or locate given parameter. Please ensure you have appropriate permissions."
ADDITIONAL INFO:
[
{
"property": "aSideIbx",
"reason": "No permission for given aSideIbx"
}
]
 

Verify the A-side IBX, and modify the value accordingly. If problem persists, contact your Master Administrator for permission information.

The A-side IBX location code is incorrect. Replace the location code with the correct value.

curl -X
GET "https://api.equinix.com/colocations/v2/patchPanels/PP:0201:122301?providerAccountNumber=300006&aSideIbx=AM1"
-H "content-type: application/json"
-H "authorization: Bearer qwErtY8zyW1abcdefGHI"

EQ-2086005

CodeEQ-2086005
DescriptionUnable to access or locate given invoice. Please ensure you have appropriate permissions.
Generic CauseUser is not permitted to access the end-point URL and resource information.
Quick FixVerify end-point URL and resource information. Refer to 'Additional Info' for more details.
ERROR SCENARIO EXAMPLE
ERROR CODE:       "EQ-2086005"
MESSAGE: "Unable to access or locate given invoice. Please ensure you have appropriate permissions."
ADDITIONAL INFO:
[
{
"property": "accountNumbers",
"reason": "No invoice found. Please ensure you are using a valid account number or have the appropriate permissions to view billing information."
}
]
 

Verify account number and modify the value accordingly. If problem persists, contact your Master Administrator for permission information.

The account number is incorrect. Replace the account number with the correct value.

curl -X 
GET "https://api.equinix.com/v2/invoices?startDate=2020-10-01&endDate=2020-12-30&accountNumbers=1132"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"

EQ-2095005

CodeEQ-2095005
DescriptionUnable to access or locate given purchase orders. Please ensure you have appropriate permissions.
Generic CauseUser is not permitted to access the end-point URL and resource information.
Quick FixVerify resource information passed in the URL.
ERROR SCENARIO EXAMPLE
ERROR CODE:   "EQ-2095005"
MESSAGE: "Unable to access or locate given purchase orders. Please ensure you have appropriate permissions."
 

Verify account number passed in the URL, and modify this value accordingly. If problem persists, contact your Master Administrator for permission information.

The account number is incorrect. Replace this with the correct value.

curl -X
GET "https://api.equinix.com//colocations/v2/purchaseOrders?accountNumbers=123456&productTypes=CROSS_CONNECT&ibxs=AM3&offset=0&limit=1"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"

EQX-121-403: Contact userName not Active and Approved

Contacts (with userName) should be Active and Approved

CodeEQX-121-403
DescriptionContacts (with userName) should be Active and Approved.
Generic CauseContact's userName passed was not active and approved.
Quick FixEnsure the contact's userName was spelled correctly, or verify the user name activity status.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQX-121-403"
MESSAGE: "Contacts (with userName) should be Active and Approved."
 

Ensure the contact's userName was spelled correctly, or verify the user name activity status. User names for Ordering contacts must be active, while user names for Technical and Notification contacts must be active or locked.

Correct the userName for Notificaiton contact from andrew4 to andrew1.

curl -X
POST "https://api.equinix.com/v1/orders/crossconnect/intracustomer?action=SUBMIT"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"
-d '{
"customerReferenceNumber": null,
"quantityRequested": 1,
"customerFollowUpRequired": false,
"schedule": {
"requestedStartDate": null,
"requestedCompletionDate": null,
"ibxTimeZone": "America/New_York",
"scheduleType": "STANDARD"
},
"purchaseOrder": {
"purchaseOrderType": "EXEMPTED"
},
"attachments": [],
"contacts": [
{
"contactType": "ORDERING",
"userName": "andrew1"
},
{
"contactType": "TECHNICAL",
"userName": "aeky",
"workPhone": "1111111",
"workPhonePrefToCall": "NEVER"
},
{
"contactType": "NOTIFICATION",
"userName": "andrew4"
}
],
"serviceDetails": {
"aside": {
"ibxLocation": {
"ibx": "DC2",
"cages": [
{
"cage": "DC2:01:002200",
"cabinets": [
"DC2:01:002200:0000"
],
"accountNumber": "887"
}
]
},
"connectionService": "COAX",
"mediaType": "COAX",
"proceedIfMediaCoverterIsRequired": true,
"protocolType": "ANTENNA",
"connectorType": "BNC",
"patchpanel": {
"name": "PP:0000:4828",
"portA": "Next Available",
"portB": "Next Available"
}
},
"zside": {
"customer": "ACCELERA SOLUTIONS, INC. - SPAWAR/Navy",
"customerAccount": "125973",
"ibxLocation": {
"ibx": "DC3",
"cages": [
{
"cage": "DC3:01:005025",
"cabinets": [
"DC3:01:005025:0204"
]
}
]
},
"connectionService": "COAX",
"connectorType": "BNC",
"patchpanel": {
"name": "PP:0204:150782",
"portA": "Next Available",
"portB": "Next Available"
},
"circuitId": "Please enter a number.",
"notifyZsideUponCompletion": false,
"zSideContactEmail": null
},
"patchEquipment": false,
"device": {},
"bmmrRequired": false,
"connectToOwnCageOrCabinet": false
}
}

EQX-121-403: User not authorized for account

You don't have permission to use this account.

CodeEQX-121-403
DescriptionYou don't have permission to use this account.
Generic CauseUnauthorized access.
Quick FixVerify authentication credentials, permissions end-point URL and resource info.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQX-121-403"
MESSAGE: "You don't have permission to use this account."
 

Verify authentication credentials, permissions end-point URL and resource info.

Rename the accountNumber value to "45786".

curl -X
POST "https://api.equinix.com/v1/orders/crossconnect/intracustomer?action=SUBMIT"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"
-d '{
"contacts": [
{
"contactType": "ORDERING",
"userName": "johndoe1"
},
{
"contactType": "TECHNICAL",
"userName": "johndoe1",
"workPhonePrefToCall": "ANYTIME"
},
{
"contactType": "NOTIFICATION",
"userName": "johndoe1"
}
],
"schedule": {
"scheduleType": "STANDARD"
},
"serviceDetails": {
"aside": {
"ibxLocation": {
"ibx": "AM1",
"cages": [
{
"cage": "AM1:0J:00PG11",
"cabinets": [
"AM1:0J:00PG11:0851"
],
"accountNumber": " "
}
]
},
"connectionService": "Multi-Mode Fiber",
"mediaType": "62.5_MICRON_MULTI-MODE_FIBER",
"protocolType": "FAST_ETHERNET",
"connectorType": "ST",
"patchpanel": {
"name": "PP:0501:10356887",
"portA": "Next Available",
"portB": "Next Available"
}
},
"zside": {
"customerAccount": "45786",
"ibxLocation": {
"ibx": "AM1",
"cages": [
{
"cage": "AM1:0J:00PG36",
"cabinets": [
"AM1:0G:00PG36:0105"
],
"accountNumber": "45786"
}
]
},
"connectionService": "Multi-Mode Fiber",
"connectorType": "ST",
"patchpanel": {
"name": "PP:0105:1034578",
"portA": "Next Available",
"portB": "Next Available"
},
"circuitId": "73/HCGS/123456/000/CC",
"loa": {}
}
}
}'

EQX-121-403: User not authorized for resource or request

Insufficient permission to access the resource or invoke the request.

CodeEQX-121-403
DescriptionInsufficient permission to access the resource or invoke the request.
Generic CauseUnauthorized access.
Quick FixVerify authentication credentials, permissions end-point URL and resource info.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQX-121-403"
MESSAGE: "Insufficient permission to access the resource or invoke the request."
 

Verify the value of the query parameter and modify the value accordingly.

Correct the ibx location code from 'AM' to 'AM1'.

curl -X
GET "https://api.equinix.com/v1/orders/crossconnect/locations?ibxs=AM"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"

EQX-121-5539: User not authorized for account

You don't have permission to access this account

CodeEQX-121-5539
DescriptionYou don't have permission to access this account
Generic CauseUnauthorized access.
Quick FixVerify authentication credentials, permissions end-point URL and resource info.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQX-121-5539"
MESSAGE: "You don't have permission to access this account"
 

Verify the value of the query parameter and modify the value accordingly.

Rename the ibx value from "AM" to "AM1".

curl -X
GET "https://api.equinix.com/v1/orders/crossconnect/providers?crossConnectType=FIBER&ibx=AM&account=kxjsxdhnwied263839&cage=sxdhfs3642628&connectTo=SERVICE_PROVIDER"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHIZZZZ"

EQX-121-5539: User not authorized for ibx, cage and account

You don't have permission to access this ibx, cage and account combination

CodeEQX-121-5539
DescriptionYou don't have permission to access this ibx, cage and account combination
Generic CauseUnauthorized access.
Quick FixVerify authentication credentials, permissions end-point URL and resource info.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQX-121-5539"
MESSAGE: "You don't have permission to access this ibx, cage and account combination"
 

Verify the value of the query parameter and modify the value accordingly.

Rename the ibx, account, and cage values from "TR1", "1627348", and "TR1:07:070442" to "AM1", "108812", and "AM1:0G:00EQ11" respectively.

curl -X
GET "https://api.equinix.com/v1/orders/crossconnect/providers?crossConnectType=STANDARD&ibx=TR1&account=1627348&cage=TR1:07:070442&connectTo=SERVICE_PROVIDER"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHIZZZZ"

EQX-816-403: User not authorized for report ID

User [username] is forbidden to access report of [reportId]

CodeEQX-816-403
DescriptionUser [username] is forbidden to access report of [reportId]
Generic CauseUnauthorized access.
Quick FixVerify authentication credentials.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQX-816-403"
MESSAGE: "User [JohnDoe] is forbidden to access report of [ffb1cb2d-d123-1b42-beb1-1b234ce5678]"
 

Verify authentication credentials to ensure correct user linked to this report is passed in the header.

Rename Bearer Token to 'aBcDeFg123456'.

curl -X
GET "https://api.equinix.com/v1/reportCenter/reports/ffb1cb2d-d123-1b42-beb1-1b234ce5678"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHIZZZZ"
-d '{
"name": "user_details_report",
"parameters": [
{
"name": "permissionCodes",
"value": "VIEW_BILLING_AND_PAYMENT_STATEMENTS"
},
{
"name": "userStatuses",
"value": "ACTIVE"
}
],
"scheduleType": "ONE_TIME",
"period": "NONE"
}'

EQX-816-403: User not authorized for report type

Forbidden to trigger a report of type [name]

CodeEQX-816-403
Description
Generic CauseUnauthorized access.
Quick FixVerify authentication credentials.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQX-816-403"
MESSAGE: "Forbidden to trigger a report of type [user_details_report]"
 

Verify authentication credentials to ensure correct user with correct permissions is passed in the header.

Rename Bearer Token to 'aBcDeFg123456'.

curl -X
POST "https://api.equinix.com/v1/reportCenter/reports/scheduler"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHIZZZZ"
-d '{
"name": "user_details_report",
"parameters": [
{
"name": "permissionCodes",
"value": "VIEW_BILLING_AND_PAYMENT_STATEMENTS"
},
{
"name": "userStatuses",
"value": "ACTIVE"
}
],
"scheduleType": "ONE_TIME",
"period": "NONE"
}'

EQX-826-403: User not authorized for account

User [username] is not authorized to access the account [accountNumber]

CodeEQX-826-403
DescriptionUser [username] is not authorized to access the account [accountNumber]
Generic CauseThe user does not have permission to this account number.
Quick FixVerify the account number passed in the URL.
ERROR SCENARIO EXAMPLE
ERROR CODE: "EQX-826-403"
MESSAGE: "User [johndoe123] is not authorized to access the account [10880]"
 

Verify the account number passed in the URL, and modify the value accordingly.

Correct the account number from "10880" to "108890".

curl -X
GET "https://api.equinix.com/v1/finance/accounts/10880"
-H "Content-type: application/json"
-H "Authorization: Bearer qwErtY8zyW1abcdefGHIZZZZ"