Get a contact book
Retrieve one contact book.
GET
https://app.usenotix.dev/api/v1/contactBooks/{contactBookId}Full access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
Retrieve one contact book.
Path parameters
contactBookIdstringrequired
Headers
Authorizationstringrequired
Bearer followed by your API key.
Errors
403
Forbidden - API key doesn't have access to this contact book
404
Contact book not found
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/contactBooks/<contactBookId>" \
-H "Authorization: Bearer $NOTIX_API_KEY"
import { Notix } from "notix-js";
const notix = new Notix(process.env.NOTIX_API_KEY);
const { data, error } = await notix.contactBooks.get("cb_123");
from notix import Notix
notix = Notix() # reads NOTIX_API_KEY
book, _ = notix.contact_books.get("cb_123")
use Notix\Notix;
$notix = new Notix(getenv('NOTIX_API_KEY'));
$book = $notix->contactBooks->get('cb_123');
Response200
{
"id": "clx1234567890",
"name": "Newsletter Subscribers",
"teamId": 1,
"properties": {
"customField1": "value1"
},
"variables": [
"registrationCode",
"company"
],
"emoji": "📙",
"createdAt": "string",
"updatedAt": "string",
"source": {
"provider": "resend",
"migratedAt": "2026-10-07T10:05:00.000Z"
}
}