List notes
curl --request GET \
--url https://app.concretehq.com/api/v1/notes \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.concretehq.com/api/v1/notes"
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/notes', 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/notes",
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/notes"
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))
}HttpResponse<String> response = Unirest.get("https://app.concretehq.com/api/v1/notes")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.concretehq.com/api/v1/notes")
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": "abc123def456",
"content": "Met with the founder; discussed **Q4 hiring plan**.",
"occurredAt": "2026-04-15T14:00:00Z",
"topics": [
"board-meeting"
],
"creator": {
"publicId": "abc123def456",
"role": "admin",
"user": {
"publicId": "654fed321cba",
"email": "john@example.com",
"firstName": "John",
"lastName": "Doe"
}
},
"companyName": "Acme",
"companyPublicId": "abc123def456"
}
]
}{
"error": "Not found"
}{
"error": "Not found"
}Notes
List notes
List notes attached to a company or a person. Exactly one of companyPublicId
or personPublicId must be provided.
GET
/
notes
List notes
curl --request GET \
--url https://app.concretehq.com/api/v1/notes \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.concretehq.com/api/v1/notes"
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/notes', 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/notes",
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/notes"
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))
}HttpResponse<String> response = Unirest.get("https://app.concretehq.com/api/v1/notes")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.concretehq.com/api/v1/notes")
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": "abc123def456",
"content": "Met with the founder; discussed **Q4 hiring plan**.",
"occurredAt": "2026-04-15T14:00:00Z",
"topics": [
"board-meeting"
],
"creator": {
"publicId": "abc123def456",
"role": "admin",
"user": {
"publicId": "654fed321cba",
"email": "john@example.com",
"firstName": "John",
"lastName": "Doe"
}
},
"companyName": "Acme",
"companyPublicId": "abc123def456"
}
]
}{
"error": "Not found"
}{
"error": "Not found"
}Authorizations
API key authentication using Bearer token format
Query Parameters
Public ID of the company whose notes to list
Public ID of the person whose notes to list
Response
List of notes
Show child attributes
Show child attributes
⌘I

