By id

GET

/listing/bid_threads/by_id/v1/:bid_thread_id

GET

/listing/bid_threads/by_id/v1/:bid_thread_id

1 import { ChrtClient } from "@chrt-inc/typescript-sdk";
2 
3 async function main() {
4     const client = new ChrtClient({
5         token: "YOUR_TOKEN_HERE",
6     });
7     await client.listing.bidThreads.byIdV1("bid_thread_id");
8 }
9 main();

1 {
2   "listing_id": "listing_9f8b7c6d5a4e3f21",
3   "created_at_timestamp": "2024-01-15T09:30:00Z",
4   "status": "open",
5   "status_changed_at_timestamp": "2024-01-15T09:30:00Z",
6   "bids": [
7     {
8       "action": "submit",
9       "acted_by_user_id": "user_98765driver",
10       "from_lister": true,
11       "created_at_timestamp": "2024-01-15T09:30:00Z",
12       "pro_forma_line_items": [
13         {
14           "item": "base_rate",
15           "rate": 150.75,
16           "quantity": 1,
17           "provenance": "rate_sheet"
18         }
19       ],
20       "comment": "Initial bid submission for the cargo transport."
21     }
22   ],
23   "_id": "bid_thread_abc123xyz789",
24   "schema_version": 1,
25   "bidder_provider_org_id": "org_12345abcde",
26   "bidder_driver_id": "driver_67890xyz",
27   "accepted_pro_forma_line_items": [
28     {
29       "item": "base_rate",
30       "rate": 150.75,
31       "quantity": 1,
32       "provenance": "rate_sheet",
33       "schema_version": 1,
34       "comments": "Approved base rate after negotiation.",
35       "units": "usd",
36       "adjustment": 0,
37       "adjustment_comments": null,
38       "rate_sheet_id": "rate_sheet_2024Q1",
39       "created_at_timestamp": "2024-01-15T09:30:00Z"
40     }
41   ]
42 }

Fetches a bid thread by id. Visible to the lister, the bidder org (provider), and the bidder driver. | authz: allowed_org_types=[provider], min_org_role=driver | () -> (BidThread1)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

bid_thread_idstringRequired

Response

Successful Response

listing_idstring

created_at_timestampdatetime

statusenum

status_changed_at_timestampdatetime

bidslist of objects

_idstring

schema_versionintegerDefaults to 1

bidder_provider_org_idstring

Must be a string starting with org_

bidder_driver_idstring

accepted_pro_forma_line_itemslist of objects

Errors

422

Bid Threads by ID V1request Unprocessable Entity Error