Skip to navigation
API ReferenceTrade Messages

List trade messages

List trade messages.

Credential: Customer session or partner secret

Before you call

  • A customer session, or an owning partner server credential without Origin.
  • A trade you own. You can send messages while it is CREATED, PAID or DISPUTED.

Owning customer only; newest page of 50, returned oldest first. Pass nextCursor as before to page backward.

Confirm with Sinbad that this endpoint is enabled in your environment.

Errors

StatusCodeWhat to do
400VALIDATION_ERRORCorrect the fields reported in details before retrying.
401UNAUTHENTICATEDCreate a new customer session or use a valid server credential.
403FORBIDDENCheck credential ownership, integration and the supplied Origin.
404NOT_FOUNDCheck the resource ID. A resource that belongs to someone else also returns 404.
409CONFLICTRead the current state again before you prepare or retry.
503UPSTREAM_ERRORRetry with backoff; preserve the same idempotency key for a repeated mutation.

Authentication

AuthorizationBearer

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

OR
AuthorizationBearer

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

Path parameters

tradeIdstringRequired

Query parameters

beforestringOptional

Response

Messages and nextCursor; no image bytes or storage paths.

messageslist of objects
nextCursorstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
503
Service Unavailable Error