7x Developer Portal & API Documentation

Loading developer portal

Preparing the API reference and documentation.

Docs

Guides & Documentation

Overview Quick Start Authentication Changelog

API Operations

All Operations

Account

Request Passwordless TokenPOST Verify Passwordless TokenPOST

POBox

Update Auto Renew ConfigurationPOST

CRM

Approve CRM AgentPOST Approve CRM RentalPOST

GuestRenewal

Confirm Guest Renewal PaymentPOST Guest Renewal DetailsGET Guest Renewed By OptionsGET Calculate Guest Renewal PricingPOST Save Guest Renewal DetailsPOST Send Guest Renewal NotificationPOST Charges For Guest Additional Renewal ServicesGET

Guest

Issuing Entities For Escher GuestGET Update Guest Auto Renew ConfigurationPOST

MOE

MOE Entities By IDGET MOE Entities By License NumberGET MOE Issuing EntitiesGET

Renewal

Cancel PO Box RenewalDELETE Renewal AgentsGET Process Renewal PaymentPOST Process Tijari Renewal PaymentPOST Save Renewal AgentPOST Save Tijari Renewal DetailsPOST Update Renewal AgentPUT Validate Renewal CancellationGET Verify Renewal CancellationPOST Renewal Additional DetailsGET PO Box Renewal DetailsGET Additional Renewal OptionsGET Charges For Additional Renewal ServicesGET Confirm Renewal PaymentPOST Renewed By OptionsGET Calculate PO Box Renewal PricingPOST Save PO Box Renewal DetailsPOST

ChangeAddress

Confirm Address Change PaymentPOST Save Address Change RequestPOST

ChangeLock

Confirm Lock Change PaymentPOST Save Lock Change RequestPOST

Rental

Rental Bundle DetailsGET Rental Expiry DatesGET Available Free BoxesGET PO Box Rental LocationsGET Rejected Box DetailsGET Rental Renewal DetailsGET Save PO Box Rental RequestPOST Select PO Box For RentalPOST Update Rental Payment StatusPOST Update Rejected Box DetailsPOST

Doc Hub

EP.Retail.PoBox.BackEnd.API EndPoints/Rental//api/v1/Rental/Select

Docs

Guides & Documentation

Overview Quick Start Authentication Changelog

API Operations

All Operations

Account

Request Passwordless TokenPOST Verify Passwordless TokenPOST

POBox

Update Auto Renew ConfigurationPOST

CRM

Approve CRM AgentPOST Approve CRM RentalPOST

GuestRenewal

Guest

Issuing Entities For Escher GuestGET Update Guest Auto Renew ConfigurationPOST

MOE

MOE Entities By IDGET MOE Entities By License NumberGET MOE Issuing EntitiesGET

Renewal

ChangeAddress

Confirm Address Change PaymentPOST Save Address Change RequestPOST

ChangeLock

Confirm Lock Change PaymentPOST Save Lock Change RequestPOST

Rental

Doc Hub

EP.Retail.PoBox.BackEnd.API EndPoints/Rental//api/v1/Rental/Select

Overview

Selects or reserves a PO Box against bundle and expiry preferences. Used after availability search and before submitting full rental details.

Request builder

POST

/api/v1/Rental/Select

api-versionstring

*object

bundleId*string

physicalBoxRequiredboolean

poBoxExpiryDatestring

uniqueBoxIDstring

holdReferenceNumberstring

Reference details

Query Parameters

api-version?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/Rental/Select" \  -H "Content-Type: application/json" \  -d '{    "bundleId": "string"  }'

{  "message": "string",  "payload": [    {      "bundle_Id": "string",      "name_En": "string",      "name_Ar": "string",      "bundle_Price": "string",      "bundle24Month_Price": "string",      "bundle36Month_Price": "string",      "bundle60Month_Price": "string",      "bundle120Month_Price": "string",      "desc_En": "string",      "desc_Ar": "string",      "short_Desc_En": "string",      "short_Desc_Ar": "string",      "features_En": "string",      "features_Ar": "string"    }  ],  "responseCode": "Continue",  "errorDetails": {    "property1": null,    "property2": null  }}

{  "message": "string",  "payload": null,  "responseCode": "Continue",  "errorDetails": {    "property1": null,    "property2": null  }}

{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "instance": "string",  "property1": null,  "property2": null}

{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "instance": "string",  "property1": null,  "property2": null}

Overview

Selects or reserves a PO Box against bundle and expiry preferences. Used after availability search and before submitting full rental details.

Request builder

POST

/api/v1/Rental/Select

api-versionstring

*object

bundleId*string

physicalBoxRequiredboolean

poBoxExpiryDatestring

uniqueBoxIDstring

holdReferenceNumberstring

Reference details

Query Parameters

api-version?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

bundleId*string

Length1 <= length

physicalBoxRequired?boolean

poBoxExpiryDate?string

Formatdate-time

uniqueBoxID?string

holdReferenceNumber?string

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/Rental/Select" \  -H "Content-Type: application/json" \  -d '{    "bundleId": "string"  }'

{  "message": "string",  "payload": [    {      "bundle_Id": "string",      "name_En": "string",      "name_Ar": "string",      "bundle_Price": "string",      "bundle24Month_Price": "string",      "bundle36Month_Price": "string",      "bundle60Month_Price": "string",      "bundle120Month_Price": "string",      "desc_En": "string",      "desc_Ar": "string",      "short_Desc_En": "string",      "short_Desc_Ar": "string",      "features_En": "string",      "features_Ar": "string"    }  ],  "responseCode": "Continue",  "errorDetails": {    "property1": null,    "property2": null  }}

{  "message": "string",  "payload": null,  "responseCode": "Continue",  "errorDetails": {    "property1": null,    "property2": null  }}

{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "instance": "string",  "property1": null,  "property2": null}

{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "instance": "string",  "property1": null,  "property2": null}

bundleId*string

Length1 <= length

physicalBoxRequired?boolean

poBoxExpiryDate?string

Formatdate-time

uniqueBoxID?string

holdReferenceNumber?string

Query Parameters

Request Body

Response Body

200application/json

400application/json

404application/json

500application/json

Query Parameters

Request Body

Response Body

200application/json

400application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`