Skip to main content
GET
/
v1
/
contacts
/
{id}
Retrieve a contact
curl --request GET \
  --url https://api.nova.net/v1/contacts/{id} \
  --header 'Authorization: Bearer <token>'
{
  "object": "contact",
  "livemode": true,
  "id": "cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI",
  "name": "Jane Doe",
  "email": "jane.doe@example.com",
  "external_reference": "contact-123"
}

Authorizations

​
Authorization
string
header
required

OAuth2 client_credentials grant for server-to-server access. Onboard via your Nova admin to receive a client_id and client_secret, then POST /oauth/token to exchange them for a short-lived access token. Send the token as Authorization: Bearer <access_token> on every authenticated request. Tokens expire after 3600 seconds — refresh by re-exchanging credentials.

Headers

​
X-Organization-Id
string

ID of the organization the request acts on. Optional when the access token is bound to a specific organization, or when the integration has access to exactly one organization.

Pattern: ^org_[A-Za-z0-9]+$
Example:

"org_Xk7d2pQR9m3nBwYz"

Path Parameters

​
id
string
required

ID of the contact

Pattern: ^cnt_[A-Za-z0-9]+$
Example:

"cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI"

Response

Contact details

​
object
enum<string>
required

Object type identifier.

Available options:
contact
Example:

"contact"

​
livemode
boolean
required

Whether this object exists in live mode (true) or test mode (false).

​
id
string
required

ID of the contact

Pattern: ^cnt_[A-Za-z0-9]+$
Example:

"cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI"

​
name
string
required

Full legal name

Required string length: 1 - 255
Example:

"Jane Doe"

​
email
string<email>
required

Email address

Example:

"jane.doe@example.com"

​
external_reference
string | null
required

Your own identifier for this contact

Example:

"contact-123"