--- title: "Get My Negotiations" url: "https://stage-api-docs.centraldispatch.com/apis/stage-offer-api-1-0-0/versions/43981ece-e7be-4c4b-a45e-0f4da174a60c/operations/getNegotiationsMine" --- > Full API specification: https://stage-api-docs.centraldispatch.com/apis/stage-offer-api-1-0-0/versions/43981ece-e7be-4c4b-a45e-0f4da174a60c.md # Get My Negotiations `GET` `/negotiations/mine` Operation ID: `getNegotiationsMine` Retrieve negotiations of current user. #### 📝 Important Notes To simply query a single listingId or carrierId use standard parameters e.g., listingId=1234 or carrierId=5678. The `eq` parameters can retrieve multiple and may be combined with `and` and `or`. Example: - eq(carrierId,123214)and(eq(listingId,1234,2345))) - eq(carrierId,123214)or(eq(listingId,1234))) - eq(carrierId,123214)or(eq(carrierId,9999))) ## Query parameters - `listingId` (string, optional) - Search for events with listing ID equal to value. - `eq(listingId,,)` (string, optional) - Search for events with listing ID equal to values. - `carrierId` (string, optional) - Search for events with carrier ID equal to value. - `eq(carrierId,,)` (string, optional) - Search for events with carrier ID equal to values. - `limit(startingPoint,numberOfResults)` (string, optional) - The maximum number of items to be returned in the response. - `startingPoint` is 1-based integer, default 1. - `numberOfResults` is an integer, default 100, maximum 500. ## Header parameters - `Accept` (string, required) - The major version of the API to make a request against. This is a custom MIME type that contains `vnd.coxauto.v[#]+`. For example, to request a resource from version 1.x.x of an API, the Accept header should be set to `application/vnd.coxauto.v1+json`. ## Responses - `200` - OK. Successful request. - `400` - Bad Request. Check the request payload. **Scenarios:** - Invalid query string paramater or format. - `401` - Unauthorized. Authentication failed or missing. - `403` - Forbidden. The attempted action is not permitted. - `429` - Too Many Requests. Rate limit exceeded. - `500` - Error. - `503` - Service Unavailable. Temporary service interruption. ## OpenAPI definition ```yaml openapi: 3.0.1 info: title: Offer API version: 1.0.0 servers: - url: https://prod-offers-api.awscal2.manheim.com description: Production server paths: /negotiations/mine: get: tags: - Negotiations summary: Get My Negotiations description: > Retrieve negotiations of current user. #### 📝 Important Notes To simply query a single listingId or carrierId use standard parameters e.g., listingId=1234 or carrierId=5678. The `eq` parameters can retrieve multiple and may be combined with `and` and `or`. Example: - eq(carrierId,123214)and(eq(listingId,1234,2345))) - eq(carrierId,123214)or(eq(listingId,1234))) - eq(carrierId,123214)or(eq(carrierId,9999))) operationId: getNegotiationsMine parameters: - name: listingId in: query description: Search for events with listing ID equal to value. schema: type: string example: "42220470" - name: eq(listingId,,) in: query description: Search for events with listing ID equal to values. schema: type: string example: eq(listingId,42220470,43000470) - name: carrierId in: query description: Search for events with carrier ID equal to value. schema: type: string example: 0ca91a43-fbee-4c05-9a6c-aa5c63888f5c - name: eq(carrierId,,) in: query description: Search for events with carrier ID equal to values. schema: type: string example: eq(carrierId,0ca91a43-fbee-4c05-9a6c-aa5c63888f5c,d4efb4d9-2418-4070-b2f9-46317d578a31) - name: limit(startingPoint,numberOfResults) in: query description: |- The maximum number of items to be returned in the response. - `startingPoint` is 1-based integer, default 1. - `numberOfResults` is an integer, default 100, maximum 500. schema: type: string example: limit(1,10) - name: Accept in: header description: The major version of the API to make a request against. This is a custom MIME type that contains `vnd.coxauto.v[#]+`. For example, to request a resource from version 1.x.x of an API, the Accept header should be set to `application/vnd.coxauto.v1+json`. required: true schema: type: string example: application/vnd.coxauto.v1+json responses: "200": description: OK. Successful request. headers: X-CoxAuto-Media-Type: description: Contains the major version and format information. schema: type: string example: coxauto.v1; format=json content: application/json: schema: $ref: "#/components/schemas/NegotiationCollection" "400": description: |- Bad Request. Check the request payload. **Scenarios:** - Invalid query string paramater or format. content: application/json: schema: $ref: "#/components/schemas/Errors" "401": description: Unauthorized. Authentication failed or missing. "403": description: Forbidden. The attempted action is not permitted. "429": description: Too Many Requests. Rate limit exceeded. "500": description: Error. content: application/json: schema: $ref: "#/components/schemas/Errors" "503": description: Service Unavailable. Temporary service interruption. security: - Bearer: [] security: - Bearer: [] components: schemas: NegotiationCollection: type: object properties: items: type: array items: $ref: "#/components/schemas/Negotiation" description: A collection of records. count: type: integer description: The total count of resources in the collection. format: int32 example: 23 href: type: string description: The URL used to query the current collection of the resource. example: https://prod-offers-api.awscal2.manheim.com/negotiations/mine description: A collection of negotiations. Errors: type: object properties: errors: type: array items: $ref: "#/components/schemas/Error" description: A collection of errors. nullable: true description: An error occurred, and the request could not be completed. Negotiation: type: object properties: href: type: string description: The fully qualified URL of the listing. example: https://example.server/examples/id/12345 createdOn: type: string description: The creation date and time of the item, in UTC/ISO 8601 format. format: date-time example: 2024-10-31T00:00:00Z negotiationId: type: string description: The ID of the offer negotiation record. format: uuid example: 157a16f0-503d-4256-ba60-a4876e8eb9bb shipperId: type: string description: The ID of the Central Dispatch customer who is the shipper. format: uuid example: afd2fb59-b89d-4572-8f9a-e57f82a61c68 carrierId: type: string description: The ID of the Central Dispatch customer chosen by the shipper to move cars in the dispatch. format: uuid example: 0ca91a43-fbee-4c05-9a6c-aa5c63888f5c listingId: type: string description: The ID of the listing. nullable: true example: "42220470" expirationUtc: type: string description: The expiration date of the listing, in UTC/ISO 8601 format. format: date-time example: 2025-09-30T00:00:00.000Z transactions: type: array items: $ref: "#/components/schemas/NegotiationTransaction" description: A collection of negotiation transactions. description: Details of a negotiation including its transactions. Error: type: object properties: code: type: string description: The code used for the issue. nullable: true example: resource.issue_type message: type: string description: A detailed message. nullable: true example: The issue happened because something is wrong. property: type: string description: The property to which the issue is associated. nullable: true example: person properties: type: object additionalProperties: type: string description: Additional properties related to the issue. nullable: true example: firstName: D0nn@ lastName: Sm!th description: Details of an error or issue. NegotiationTransaction: type: object properties: offerTransactionId: type: string description: The ID of the offer negotiation record. format: uuid example: 3fde6068-5fa2-4ae4-af16-06d65fc87dc9 amount: type: number description: The balance amount that will be due after the COD/COP payment is applied. format: double example: 300 deliveryDate: type: string description: The desired delivery date of the listing, in UTC/ISO 8601 format. format: date-time example: 2025-10-04T00:00:00.000Z pickupDate: type: string description: The date the pick up is scheduled, in UTC/ISO 8601 format. format: date-time example: 2025-09-27T00:00:00.000Z transactionType: $ref: "#/components/schemas/TransactionType" userId: type: string description: The Central Dispatch user ID. format: uuid example: d71b5750-e89b-12d3-a456-426614174000 createdOn: type: string description: The creation date and time of the item, in UTC/ISO 8601 format. format: date-time example: 2024-10-31T00:00:00Z description: Details of a transaction within a negotiation. TransactionType: enum: - ORIGINAL_ASK - INITIAL_OFFER - MODIFICATION - REJECTION - ACCEPTANCE - REACTIVATION - ARCHIVAL - SYSTEM_REJECTION - EXPIRATION - AUTO_ACCEPTANCE - REVOKED type: string description: Different types of transactions that can occur within a negotiation. This list is not exhaustive and additional values may be added at any time. example: INITIAL_OFFER securitySchemes: Bearer: type: http scheme: Bearer ```