Request a Document Pull

The second method to upload a document to your port order is to have the Porting service retrieve your document from a public location. In that case, you specify the URL of your file.


POST portorders/:portorder_id/upload_file

Body Parameters

  • filename
    string Required

    The full path to the file to be uploaded.

  • Optional Query Parameters

  • filename

    Allows the user to specify a friendly name to refer to this file content. Mainly used when the URL is some sort of complex server side request.

Response Fields

On success, the HTTP status code in the response header is 200 OK and the response body contains information on the document request. On error, the header status code is an error code and the response body contains an array of error objects.

  • data

    Document request object composed of the following:

    • attributes

      Object composed of attributes relating to the state of the request.

      • filename

        The original URL specified in the request.

      • file

        The 'shortened' name of the file if specified.

      • status

        The status of the document upload. Possible status values are:

        • pending
        • processing
        • complete
        • error
    • id

      ID assigned to the document process.

    • links

      Links object pointing to the status for this document.

      For example, https://...portorders/394822/files/99999.

    • type

      This will always be portorder-file.

Example Request

POST /v2/portorders/portorder_id/upload_file HTTP/1.1
Content-Type: application/json
Accept: application/json

    "filename": "/fullpath/to/carrer_bill.pdf?filename=carrier_bill.pdf"

Example Request

curl -X POST -u accessKey:secretKey -d '{"filename": "/fullpath/to/carrer_bill.pdf?filename=carrier_bill.pdf"}' -H 'Content-Type':'application/json'

Example Response


200 OK

  "data": {
    "attributes": {
      "filename": "",
      "file": "carrier_bill.pdf",
      "status": "processing"
    "id": "51026",
    "links": {
      "self": ""
    "type": "portorder-file"