Get a customer

GET

/api/v1/customers/{id}

Embeds a summary of every questionnaire and RFP linked to the customer. Fetch each one by id for the full record.

Authorizations

bearerAuth

Path Parameters

NameType

required

string

The record’s prefixed ID

Responses

200

The customer, with questionnaires embedded

Response body

application/json

object

string

name

string

questionnaires_count

integer

rfps_count

integer

created_at

string format: date-time

updated_at

string format: date-time

questionnaires

Array<object>

A questionnaire or RFP linked to a customer

object

string

title

string

state

string

The questionnaire or RFP state; see the full schema for allowed values

deadline

string | null format: date

created_at

string format: date-time

web_link

string format: uri

rfps

Array<object>

A questionnaire or RFP linked to a customer

object

string

title

string

state

string

The questionnaire or RFP state; see the full schema for allowed values

deadline

string | null format: date

created_at

string format: date-time

web_link

string format: uri

404

No such record in this account

Response body

application/json

object

error

object

code

string

A stable machine-readable code

message

string

details

Array<string>

Present on validation errors; one entry per failed validation

Request

curl --request GET \
  --url https://app.responsehub.io/api/v1/customers/example \
  --header 'Authorization: Bearer <token>'

require 'uri'
require 'net/http'

url = URI("https://app.responsehub.io/api/v1/customers/example")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://app.responsehub.io/api/v1/customers/example', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();

const url = 'https://app.responsehub.io/api/v1/customers/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://app.responsehub.io/api/v1/customers/example"

  req, _ := http.NewRequest("GET", url, nil)

  req.Header.Add("Authorization", "Bearer <token>")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

200example

Example^generated

{
  "id": "cust_1a2b",
  "name": "example",
  "questionnaires_count": 1,
  "rfps_count": 1,
  "created_at": "2026-04-15T12:00:00Z",
  "updated_at": "2026-04-15T12:00:00Z",
  "questionnaires": [
    {
      "id": "qu_1a2b",
      "title": "example",
      "state": "example",
      "deadline": "2026-04-15",
      "created_at": "2026-04-15T12:00:00Z",
      "web_link": "https://example.com"
    }
  ],
  "rfps": [
    {
      "id": "qu_1a2b",
      "title": "example",
      "state": "example",
      "deadline": "2026-04-15",
      "created_at": "2026-04-15T12:00:00Z",
      "web_link": "https://example.com"
    }
  ]
}

404example

Example^generated

{
  "error": {
    "code": "not_found",
    "message": "example",
    "details": [
      "example"
    ]
  }
}