curl --request POST \
  --url https://api.bridge.xyz/v0/rfis/{rfiID}/responses \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "responses": [
    {
      "requested_item_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "free_text_explanation": "Personal savings accumulated over several years."
    }
  ]
}
'

{}

RFIs

Submit responses to an RFI

Submits one or more responses to outstanding requested items on an RFI. All responses are applied atomically — any failure rolls back the entire batch.

Required scope: customer:write

Field names encode whether the value is a scalar or a list. Fields ending in _list accept one or more values; all other fields accept a single value.

Field	Type	Notes
`text`	string	Single text value (e.g. name, description)
`text_list`	array of strings	Multiple text values (e.g. nationalities, industries)
`date`	string	ISO 8601 date (`YYYY-MM-DD`)
`address`	object	Postal address
`boolean`	boolean	`true` or `false`; `false` is a valid answer
`free_text_explanation`	string	Supplemental explanation; accepted alongside most other fields
`identifying_information_list`	array of objects	ID documents or tax IDs
`document_list`	array of objects	File attachments (base64 data-URI); maximum 24MB total per item

Most items accept more than one field. You may submit any or all of the accepted fields in a single response object; Bridge processes each one you provide.

Use GET /rfis/{id} to retrieve the RFI and inspect each item’s response_types array to see which fields are accepted for that item.

POST

rfis

{rfiID}

responses

curl --request POST \
  --url https://api.bridge.xyz/v0/rfis/{rfiID}/responses \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "responses": [
    {
      "requested_item_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "free_text_explanation": "Personal savings accumulated over several years."
    }
  ]
}
'

{}

Authorizations

Api-Key

string

header

required

Headers

Idempotency-Key

string

required

Path Parameters

rfiID

string

required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

Pattern: [a-z0-9]*

Body

application/json

responses

object[]

required

One or more response items. Applied atomically — a failure on any item rolls back the entire batch.

Minimum array length: 1

Show child attributes

Response

All responses accepted and applied.

The response is of type object.