Offers

Receiving a paginated list of your own offers

get

Authorizations

getKeyheaderKey

Query parameters

limitinteger · min: 1 · max: 50Optional

Limit on the number of offers listed per pagination iteration

Default: 25

offsetintegerOptional

Offset of the paginated selection of offers relative to the previous selection

Default: 0

offers_statusstring · enumOptional

Select offers of a certain status

Possible values:

offers_typestring · enumOptional

Select offers of a certain type

Possible values:

Header parameters

Content-Typestring · enumRequiredDefault: application/jsonPossible values:

Accept-Encodingstring · enumRequiredDefault: gzipPossible values:

Responses

200

Successful execution of the request

application/json

400

Error in input data

application/json

401

Request not authorized. API key may be missing.

403

This operation is not permitted.

get

HTTPcURLJavaScriptPython

GET /public-api/v1/company/offers HTTP/1.1
Host: api.test.roolz.tech
Content-Type: application/json
Accept-Encoding: gzip
Accept: */*

{
  "total": 1,
  "count": 1,
  "offers": []
}

Getting a paginated list of incoming offers on a private exchange

get

Authorizations

getKeyheaderKey

Query parameters

limitinteger · min: 1 · max: 50Optional

Limit on the number of offers listed per pagination iteration

Default: 25

offsetintegerOptional

Offset of the paginated selection of offers relative to the previous selection

Default: 0

Header parameters

Content-Typestring · enumRequiredDefault: application/jsonPossible values:

Accept-Encodingstring · enumRequiredDefault: gzipPossible values:

Responses

200

Successful execution of the request

application/json

400

Error in input data

application/json

401

Request not authorized. API key may be missing.

403

This operation is not permitted.

get

HTTPcURLJavaScriptPython

GET /public-api/v1/company/offers/incoming HTTP/1.1
Host: api.test.roolz.tech
Content-Type: application/json
Accept-Encoding: gzip
Accept: */*

{
  "total": 1,
  "count": 1,
  "offers": []
}

Getting an offer by the unique ID

get

Authorizations

getKeyheaderKey

Path parameters

idstringRequired

Unique offer ID

Header parameters

Content-Typestring · enumRequiredDefault: application/jsonPossible values:

Accept-Encodingstring · enumRequiredDefault: gzipPossible values:

Responses

200

Successful execution of the request

application/json

400

Error in input data

application/json

401

Request not authorized. API key may be missing.

403

This operation is not permitted.

get

HTTPcURLJavaScriptPython

GET /public-api/v1/offer/{id} HTTP/1.1
Host: api.test.roolz.tech
Content-Type: application/json
Accept-Encoding: gzip
Accept: */*

{
  "offer": {
    "id": "text",
    "name": "text",
    "type": "cargo",
    "status": "not_published",
    "creation_method": "manual",
    "is_public": true,
    "is_private": true,
    "company_id": "text",
    "description": "text",
    "assignee_users": [],
    "is_autoclosed": true,
    "is_publication_autocanceled": true,
    "publication_autocancel_type": "text",
    "publication_autocancel_at": "Y-m-dTHH:mm:ss.SSSZ",
    "status_changed_at": "Y-m-dTHH:mm:ss.SSSZ",
    "published_at": "Y-m-dTHH:mm:ss.SSSZ",
    "closed_at": "Y-m-dTHH:mm:ss.SSSZ",
    "autoclose_at": "Y-m-dTHH:mm:ss.SSSZ",
    "is_all_private_partners": true,
    "private_partners": [
      "text"
    ],
    "route": [],
    "route_way": {
      "total_length": 1,
      "total_dur": 1
    },
    "transportation_requirement": {
      "is_trailer_interchange": true,
      "shipping_mode": "any",
      "type": "any",
      "body": [
        "curtainside"
      ],
      "equipment": "text",
      "quantity": "text"
    },
    "cargo_units": [],
    "transport": {
      "is_trailer_interchange": true,
      "type": "any",
      "temperature_min_c": 1,
      "temperature_max_c": 1,
      "available_weight": 1,
      "available_volume": 1,
      "length": 1,
      "width": 1,
      "height": 1,
      "shipping_mode": [
        "any"
      ],
      "adr_class": [
        "no"
      ],
      "body": [],
      "equipment": "text",
      "loading_type": [
        "rear"
      ]
    },
    "created_at": "Y-m-dTHH:mm:ss.SSSZ",
    "updated_at": "Y-m-dTHH:mm:ss.SSSZ"
  }
}