How to Use the TreeTrace Web Service in Postman

The archive below contains ready-made files that you can import into Postman.
Please note that after importing the request set, you must enter the Username and Password obtained during the registration process.

Below guide will walk you through the exact steps to manually create and use TreeTrace Web Service in Postman.


1) Get the Token (Basic Auth)

  1. Open Postman and click New Request

  2. Set request type to POST

  3. Enter the URL:

    • Development: https://treetracesrv-dev.sylvamo.com/Auth/token
    • Production: https://treetracesrv.sylvamo.com/Auth/token
  4. Go to the Authorization tab:

    • Type: Basic Auth
    • Username: [YourUsername]
    • Password: [YourPassword]
      Postman will automatically set the Authorization header like this:
      Authorization: Basic base64(username:password)
  5. Go to the Body tab:

    • Type: raw
    • Format: JSON
    • Leave the body empty or just use empty object {} if required.
  6. Click Send.

GetToken Page Screenshot


2) Copy the Token from the Response

  1. You’ll get a response like:
    {
     "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp..."
    }
    
    • Copy the value of the token field.

3) Request Tree Trace Data

  1. Create a New Request in Postman.

    • Method: POST
  2. Enter the URL:

    • Development: https://treetracesrv-dev.sylvamo.com/Eudr/GetRecords
    • Production: https://treetracesrv.sylvamo.com/Eudr/GetRecords
  3. Go to the Authorization tab:

    • Type: Bearer Token
    • Paste the token you copied in the previous step.

    Authorization Captcha Screenshot

  4. Go to the Headers tab (optional, Postman usually adds it):

    • Add a header: Content-Type: application/json
      Accept: */*

    Headers Captcha Screenshot

  5. Go to the Body tab:

    • Type: raw
    • Format: JSON
    • Enter a body like:
     {
       "invoiceNumber": "123456",
       "loadNumber": "78910",
       "customerPo": "654321"
     }
     
    • You can leave either field empty or skip the empty entries entirely:
     {
       "customerPo": "654321"
     }
     OR
     {
       "invoiceNumber": "",
       "loadNumber": "",
       "customerPo": "654321"
     }
     
  6. Click Send

Result Captcha Screenshot


4) Request Tree Trace GeoJson

  1. Create a New Request in Postman.

    • Method: POST
  2. Enter the URL:

    • Development: https://treetracesrv-dev.sylvamo.com/Eudr/GetGeoJson
    • Production: https://treetracesrv.sylvamo.com/Eudr/GetGeoJson
  3. Go to the Authorization tab:

    • Type: Bearer Token
    • Paste the token you copied in the previous step.

    Authorization Captcha Screenshot

  4. Go to the Headers tab (optional, Postman usually adds it):

    • Add a header: Content-Type: application/json
      Accept: */*

    Headers Captcha Screenshot

  5. Go to the Body tab:

    • Type: raw
    • Format: JSON
    • Enter a body like:
     {
       "invoiceNumber": "123456",
       "loadNumber": "78910",
       "customerPo": "654321"
     }
     
    • You can leave either field empty or skip the empty entries entirely:
     {
       "customerPo": "654321"
     }
     OR
     {
       "invoiceNumber": "",
       "loadNumber": "",
       "customerPo": "654321"
     }
     
  6. Click Send

Result Captcha Screenshot


5) View the Response

If successful, you’ll receive the tree trace data as JSON.
If token is invalid/expired, you'll get a 401 Unauthorized or similar error.


An error has occurred. This application may no longer respond until reloaded. Reload 🗙