List company touchpoints

curl --request GET \
  --url https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints"

	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(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints")

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

{
  "items": [
    {
      "publicId": "tch123abc456",
      "headline": "Acme May 2026 investor update",
      "topics": [
        "periodic-company-update"
      ],
      "occurredAt": "2026-06-01T12:00:00Z",
      "updatedAt": "2026-06-02T08:14:09Z",
      "snippet": "May update covering ARR growth, the enterprise launch timeline, and two senior hires.",
      "emailCount": 2,
      "noteCount": 0,
      "meetingCount": 0,
      "fileCount": 1,
      "insights": [
        {
          "publicId": "ins789ghi012",
          "category": "growth",
          "content": "ARR reached $24M in May, up 18% since the February update.",
          "occurredAt": "2026-06-01T12:00:00Z",
          "citations": [
            {
              "type": "file",
              "publicId": "fil789ghi012",
              "name": "Acme May 2026 Investor Update.pdf",
              "extension": "pdf",
              "permalink": "https://app.concretehq.com/v/fil789ghi012"
            }
          ]
        }
      ]
    }
  ]
}

GET

companies

{companyPublicId}

touchpoints

List company touchpoints

curl --request GET \
  --url https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints"

	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(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.concretehq.com/api/v1/companies/{companyPublicId}/touchpoints")

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

{
  "items": [
    {
      "publicId": "tch123abc456",
      "headline": "Acme May 2026 investor update",
      "topics": [
        "periodic-company-update"
      ],
      "occurredAt": "2026-06-01T12:00:00Z",
      "updatedAt": "2026-06-02T08:14:09Z",
      "snippet": "May update covering ARR growth, the enterprise launch timeline, and two senior hires.",
      "emailCount": 2,
      "noteCount": 0,
      "meetingCount": 0,
      "fileCount": 1,
      "insights": [
        {
          "publicId": "ins789ghi012",
          "category": "growth",
          "content": "ARR reached $24M in May, up 18% since the February update.",
          "occurredAt": "2026-06-01T12:00:00Z",
          "citations": [
            {
              "type": "file",
              "publicId": "fil789ghi012",
              "name": "Acme May 2026 Investor Update.pdf",
              "extension": "pdf",
              "permalink": "https://app.concretehq.com/v/fil789ghi012"
            }
          ]
        }
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

API key authentication using Bearer token format

Path Parameters

companyPublicId

string

required

Company public ID

Query Parameters

pageToken

string

Token for pagination to get next page

limit

integer

default:100

Number of results per page (default: 100, max: 100)

Required range: 1 <= x <= 100

topic

enum<string>[]

Only touchpoints with these topics. Repeat the parameter to pass multiple (e.g. ?topic=board-meeting&topic=company-announcement).

Available options:

periodic-company-update,

company-announcement,

board-meeting,

adhoc-company-update,

legal-communication,

other

Response

List of touchpoints

items

object[]

required

Show child attributes

nextPageToken

string

Token for fetching next page

Example:

"next_page_token_here"

Get Started

Guides

Trackers

Email Intelligence

Meeting Intelligence

Apps & Services

API

API Reference

List company touchpoints

Authorizations

Path Parameters

Query Parameters

Response