List signals
curl --request GET \
--url https://api.civicmarketplace.com/v1/signals \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.civicmarketplace.com/v1/signals"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.civicmarketplace.com/v1/signals', 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://api.civicmarketplace.com/v1/signals",
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://api.civicmarketplace.com/v1/signals"
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://api.civicmarketplace.com/v1/signals")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.civicmarketplace.com/v1/signals")
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{
"data": [
{
"id": "sig_aj4k",
"supplier": {
"id": "sup_1r",
"name": "Acme Water Services"
},
"title": "Water meter replacement",
"entity_name": "City of Austin",
"state": "TX",
"city": "Austin",
"meeting_date": "2026-10-14",
"description": "Council approved replacing 12,000 residential water meters over two years and asked staff to bring back vendor options by January.",
"estimated_amount": 125000.5,
"contact": {
"name": "Jordan Lee",
"title": "Utilities Director",
"email": "[email protected]"
},
"matching_contracts": [
{
"id": "ctr_3f",
"name": "Water Metering Equipment and Services"
}
],
"video_url": "https://example.gov/meetings/2026-10-14",
"video_timestamp_seconds": 2715,
"status": "new",
"contacted": false,
"not_relevant_note": null
}
],
"meta": {
"next_cursor": "eyJpIjoxMjN9.c2ln",
"limit": 25
}
}{
"error": {
"code": "validation_failed",
"message": "invalid cursor",
"request_id": "3f1c2a9e-5b7d-4e8a-9c61-2d0f4b8e7a13"
}
}{
"error": {
"code": "unauthorized",
"message": "unauthorized",
"request_id": "3f1c2a9e-5b7d-4e8a-9c61-2d0f4b8e7a13"
}
}{
"error": {
"code": "forbidden",
"message": "this API key has no access to supplier signals; ask Civic Marketplace to enable it",
"request_id": "3f1c2a9e-5b7d-4e8a-9c61-2d0f4b8e7a13"
}
}{
"error": {
"code": "not_found",
"message": "supplier not found",
"request_id": "3f1c2a9e-5b7d-4e8a-9c61-2d0f4b8e7a13"
}
}{
"error": {
"code": "rate_limited",
"message": "rate limit exceeded",
"request_id": "3f1c2a9e-5b7d-4e8a-9c61-2d0f4b8e7a13"
}
}Signals
List Signals
Buying signals found in public meetings, such as a council agreeing to replace water meters, matched to the suppliers your API key may read. Results are ordered newest match first. Read-only: this endpoint never marks a signal as viewed or contacted.
Civic Marketplace grants signal access per supplier. A key with no signal access gets 403.
To pull new signals on a schedule, page from the start and stop at the first id you already hold. The order follows when each signal was matched to the supplier, not its id, so compare ids for equality only. See Syncing Data.
GET
/
v1
/
signals
List signals
curl --request GET \
--url https://api.civicmarketplace.com/v1/signals \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.civicmarketplace.com/v1/signals"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.civicmarketplace.com/v1/signals', 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://api.civicmarketplace.com/v1/signals",
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://api.civicmarketplace.com/v1/signals"
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://api.civicmarketplace.com/v1/signals")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.civicmarketplace.com/v1/signals")
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{
"data": [
{
"id": "sig_aj4k",
"supplier": {
"id": "sup_1r",
"name": "Acme Water Services"
},
"title": "Water meter replacement",
"entity_name": "City of Austin",
"state": "TX",
"city": "Austin",
"meeting_date": "2026-10-14",
"description": "Council approved replacing 12,000 residential water meters over two years and asked staff to bring back vendor options by January.",
"estimated_amount": 125000.5,
"contact": {
"name": "Jordan Lee",
"title": "Utilities Director",
"email": "[email protected]"
},
"matching_contracts": [
{
"id": "ctr_3f",
"name": "Water Metering Equipment and Services"
}
],
"video_url": "https://example.gov/meetings/2026-10-14",
"video_timestamp_seconds": 2715,
"status": "new",
"contacted": false,
"not_relevant_note": null
}
],
"meta": {
"next_cursor": "eyJpIjoxMjN9.c2ln",
"limit": 25
}
}{
"error": {
"code": "validation_failed",
"message": "invalid cursor",
"request_id": "3f1c2a9e-5b7d-4e8a-9c61-2d0f4b8e7a13"
}
}{
"error": {
"code": "unauthorized",
"message": "unauthorized",
"request_id": "3f1c2a9e-5b7d-4e8a-9c61-2d0f4b8e7a13"
}
}{
"error": {
"code": "forbidden",
"message": "this API key has no access to supplier signals; ask Civic Marketplace to enable it",
"request_id": "3f1c2a9e-5b7d-4e8a-9c61-2d0f4b8e7a13"
}
}{
"error": {
"code": "not_found",
"message": "supplier not found",
"request_id": "3f1c2a9e-5b7d-4e8a-9c61-2d0f4b8e7a13"
}
}{
"error": {
"code": "rate_limited",
"message": "rate limit exceeded",
"request_id": "3f1c2a9e-5b7d-4e8a-9c61-2d0f4b8e7a13"
}
}
