Developer Console

Construct URI and authorize request

  1. Select one of the three available endpoints listed in this table. To improve latency, choose the endpoint that is closest to your infrastructure geographical area. You can switch to another endpoint at any time.
Endpoint Region
intake.eu-west-1.portability.data.amazon Europe (Dublin)
intake.us-east-1.portability.data.amazon US East (N. Virginia)
intake.us-west-2.portability.data.amazon US West (Oregon)

In your Application, use your preferred library to connect to one of the endpoints and perform HTTP requests for the path supported by Amazon Data Portability.

  1. Construct the URI using the next reference:
Name Description Example
Method One of the Amazon Data Portability HTTP methods. GET
Endpoint An Amazon Data Portability endpoint. intake.eu-west-1.portability.data.amazon
Path Path for the API. /{scopeId}/data-queries/{queryId}/records
Query string The query parameters. ?maxResults=10

Examples:
POST https://intake.eu-west-1.portability.data.amazon/portability-physical-orders/data-queries
GET https://intake.eu-west-1.portability.data.amazon/portability-physical-orders/data-queries/a1111111-b222-c333-d444-e55555555555/records

  1. Add the access token in the authorization header.

Examples using CURL:

curl 
  --request POST 'https://intake.eu-west-1.portability.data.amazon/portability-physical-orders/data-queries' \
  -H 'authorization: Bearer $ACCESS_TOKEN' \
  -l
  
curl 
  --request GET 'https://intake.eu-west-1.portability.data.amazon/portability-physical-orders/data-queries/a1111111-b222-c333-d444-e55555555555/records' \
  -H 'authorization: Bearer $ACCESS_TOKEN' \
  -l

Your Application is now ready to connect with Amazon Data Portability API.


Last updated: Mar 07, 2024