Get Location

GET /locations/{location_id}

Get location configuration.

Roles

Users with the following roles may access this endoint:

Admin
ClientCustomer
CrmUser
Dispatcher
Driver
ThirdPartyDispatcher
ThirdPartyDriver

Breaking Changes

No breaking changes.

Request

Sample Request
Sample Response

GET /locations/{location_id}/
Authorization: Bearer {your-auth-token}
Content-Type: application/json
x-tenant-id: {your-tenant-id}

Access-Control-Allow-Headers: Authorization, Accept, X-TENANT-ID, Content-Type
Access-Control-Allow-Methods: GET
Access-Control-Allow-Origin: *
Allow: GET
Content-Length: 2313
Content-Type: application/json
Date: Sat, 20 Aug 2022 01:43:24 GMT
Server: WSGIServer/0.2 CPython/3.9.5
X-API-VERSION: 2019/02/08
X-REQUEST-ID: d788fc27-fefe-4b92-89f2-d315a34d8e7c

{
"address": {
  "id": null,
  "latitude": 48.0766427,
  "line_1": "24 Lee Chatfield Way",
  "line_2": null,
  "line_3": null,
  "line_4": null,
  "locality": "Sequim",
  "longitude": -123.087925,
  "postcode": "98382",
  "region": "Wa"
},
"allow_new_asset_numbers": false,
"asset_number_required": false,
"auto_billing_setup": false,
"auto_complete_dumps": false,
"auto_rollover_enabled": true,
"bar_code_type": "code_39",
"billing_accounts_global": false,
"contact": {
  "email": "support@smsrolloffs.com",
  "id": null,
  "name": null,
  "number": "360-555-1212"
},
"delivery_hidden": false,
"delivery_name": "LiveLoad",
"distance_factor": 0.621371,
"distance_label": "mi",
"do_share_drivers": true,
"driver_self_assignment": false,
"dropoff_hidden": false,
"dropoff_name": "Delivery",
"dtt_enabled": false,
"exchange_hidden": false,
"exchange_name": "Swap",
"id": 1,
"is_active": true,
"leed_enabled": null,
"main_inventory_name": "SMS Sequim",
"name": "SMS RollOffs",
"notify_on_acknowledged_job": false,
"notify_on_completed_job": false,
"notify_on_dispatched_job": true,
"notify_on_failed_job": true,
"pickup_hidden": false,
"pickup_name": "Pickup",
"require_reason_fail_delay": true,
"require_reference_number": false,
"require_signature": false,
"service_disclaimer": "Electronic Signature (e-Signature): You consent and agree that your use of a key pad, mouse or other device to select an item, button, icon or similar act/action while using any electronic service we offer; or in accessing or making any transactions regarding any document, agreement, acknowledgement, consent, term, disclosure, or condition constitutes your signature, acceptance and agreement as if actually signed by you in writing. Further, you agree that no certification authority or other third party verification is necessary to validate your electronic signature; and that the lack of such certification or third party verification will not in any way affect the enforceability of your signature or resulting contract. You understand and agree that your eSignature executed in conjunction with the electronic submission of your application will be legally binding and such transaction will be considered authorized by you. \n\nTest here 1\n\nNext line\n\nNext One, two, three",
"service_hidden": false,
"service_name": "Service",
"use_additional_items": true
}

Path Parameters

location_id Integer, Required

Location identifier.

Query Parameters

note

No query parameters.

Request Headers

Refer to StandardRequestHeadersModel for more details.

authorization String, Required

Authorization header (bearer with access token). See the Authentication Guide to get started.

Matches ^bearer [a-z0-9-_=]+.[a-z0-9-_=]+.?[a-z0-9-_.+/=]*$
No longer than 256 characters.
At least 1 characters long.

x-api-version String, Optional

Request identifier.

At least 1 and no more than 64 characters.
Must be a valid API version string (2019/02/08, 2021/04/07, 2021/05/07, 2021/08/02, 2021/11/04, 2023/04/19).

x-tenant-id Integer, Required

Tenant identifier. Contact CRO Software for more info if you don't already have this id. See list tenant ids for info on listing the tenants you have access to.

Request Body

note

No request body

Response

Response Headers

Refer to StandardResponseHeadersModel for more details.

x-api-version String

Request identifier.

At least 1 and no more than 64 characters.
Must be a valid API version string (2019/02/08, 2021/04/07, 2021/05/07, 2021/08/02, 2021/11/04, 2023/04/19).

x-request-id String

Request identifier.

Valid UUID.

Response Body

Refer to LocationModel for more details.

address Object

LocationAddressModel

allow_new_asset_numbers Boolean

Allow input of new asset numbers.

One of 0, 1, True, False (case insensitive).

asset_number_required Boolean

Require assets to have numbers.

One of 0, 1, True, False (case insensitive).

auto_billing_setup Boolean

Automatically open billing when a customer is created through the CC.

One of 0, 1, True, False (case insensitive).

auto_complete_dumps Boolean

Automatically complete dump jobs.

One of 0, 1, True, False (case insensitive).

auto_rollover_enabled Boolean

Automatically move pending jobs scheduled for a date in the past to the current date.

One of 0, 1, True, False (case insensitive).

bar_code_type String

(deprecated) Set to any value to enable barcode scanning.

At least 1 and no more than 64 characters.

billing_accounts_global Boolean

Share billing accounts between locations.

One of 0, 1, True, False (case insensitive).

contact Object

LocationContactModel

delivery_hidden Boolean

Hide delivery job type in user interfaces, except for existing delivery jobs (job type 'L').

One of 0, 1, True, False (case insensitive).

delivery_name String

Name used in the UI which replaces the word 'Delivery' for job types (job type 'L').

At least 1 and no more than 12 characters.

distance_factor Float

Conversion factor to get from kilometers to the desired distance unit of measurement

Greater than or equal to 0.0.

distance_label String

Distance unit of measurement

At least 0 and no more than 20 characters.

do_share_drivers Boolean

Share drivers between locations

One of 0, 1, True, False (case insensitive).

driver_self_assignment Boolean

Driver can self assign.

One of 0, 1, True, False (case insensitive).

dropoff_hidden Boolean

Hide dropoff job type in user interfaces, except for existing delivery jobs (job type 'D').

One of 0, 1, True, False (case insensitive).

dropoff_name String

Name used in the UI which replaces the word 'Dropoff' for job types (job type 'D').

At least 1 and no more than 12 characters.

dtt_enabled Boolean

Enables the Daily Truck Timeline.

One of 0, 1, True, False (case insensitive).

exchange_hidden Boolean

Hide exchange job type in user interfaces, except for existing exchange jobs (job type 'E').

One of 0, 1, True, False (case insensitive).

exchange_name String

Name used in the UI which replaces the word 'Exchange' for job types (job type 'E').

At least 1 and no more than 12 characters.

id Integer

Location identifier.

is_active Boolean

Records marked inactive are treated as deleted (soft delete).

One of 0, 1, True, False (case insensitive).

leed_enabled Boolean

Enable LEED features.

One of 0, 1, True, False (case insensitive).

main_inventory_name String

Name of the location's main inventory.

At least 0 and no more than 64 characters.

name String

Name for a location.

At least 1 and no more than 64 characters.

notify_on_acknowledged_job Boolean

Send email notification to the location's contact when a job is acknowledged.

One of 0, 1, True, False (case insensitive).

notify_on_completed_job Boolean

Send email notification to the location's contact when a job is completed.

One of 0, 1, True, False (case insensitive).

notify_on_dispatched_job Boolean

Send email notification to the location's contact when a job is dispatched.

One of 0, 1, True, False (case insensitive).

notify_on_failed_job Boolean

Send email notification to the location's contact when a job is failed.

One of 0, 1, True, False (case insensitive).

pickup_hidden Boolean

Hide pickup job type in user interfaces, except for existing pickup jobs (job type 'P').

One of 0, 1, True, False (case insensitive).

pickup_name String

Name used in the UI which replaces the word 'Pickup' for job types (job type 'P').

At least 1 and no more than 12 characters.

require_reason_fail_delay Boolean

Require drivers to input the reason that a job was failed or delayed

One of 0, 1, True, False (case insensitive).

require_reference_number Boolean

Require reference numbers when creating or editing jobs.

One of 0, 1, True, False (case insensitive).

require_signature Boolean

Require drivers to collect signatures when completing jobs.

One of 0, 1, True, False (case insensitive).

service_disclaimer String

Service disclaimer text presented to customers when drivers acquire signatures.

At least 0 and no more than 10485760 characters.

service_hidden Boolean

Hide service job type in user interfaces, except for existing service jobs (job type 'R').

One of 0, 1, True, False (case insensitive).

service_name String

Name used in the UI which replaces the word 'Service' for job types (job type 'R').

At least 1 and no more than 12 characters.

use_additional_items Boolean

Use additional items.

One of 0, 1, True, False (case insensitive).

Code Samples

cURL
Python
CSharp 2.0

curl --request GET --include \
--header "Authorization: Bearer {your-auth-token}" \
--header "Content-Type: application/json" \
--header "x-tenant-id: {your-tenant-id}" \
127.0.0.1:8003/locations/{location_id}

import requests, json

response = requests.get(
  'http://localhost:8003/locations/{location_id}',
  headers={
    'Authorization': 'Bearer {your-auth-token}',
    'Content-Type': 'application/json',
    'x-tenant-id': '{your-tenant-id}'
  },
  parameters={
  }
)
results = json.loads(response.text)
print(results)

using System;
using System.Net;
using System.Collections.Specialized;

namespace CROSoftware
{
public class DemoClient
{
    static public void Main ()
    {
        WebClient client = new WebClient();

        // URL    
        String url = "/locations/{location_id}";

        // Headers
        client.Headers.Add("Authorization", "Bearer {your-auth-token}");
        client.Headers.Add("Content-Type", "application/json");
        client.Headers.Add("x-tenant-id", "{your-tenant-id}");

        string json = client.DownloadString(url);
        Console.WriteLine(json);
    }
}
}

Get Location

Roles​

Breaking Changes​

Request​

Path Parameters​

Query Parameters​

Request Headers​

Request Body​

Response​

Response Headers​

Response Body​

Code Samples​

Roles

Breaking Changes

Request

Path Parameters

Query Parameters

Request Headers

Request Body

Response

Response Headers

Response Body

Code Samples