---
title: "Get a specific contact"
method: GET
path: "/contacts/{contactId}"
tags: ["Contacts"]
---

# Get a specific contact

`GET /contacts/{contactId}`

## Request

- Base URL: `https://api.loopify.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.loopify.com/contacts/{contactId}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.loopify.com/connect/authorize`, token URL `https://auth.loopify.com/token`, scopes: `ContactDataManagement`, `ReadContacts`, `AccountAPIKey`)

#### Auth policies: ContactDataManagement,ReadContacts,AccountAPIKey

## Path parameters

- `contactId` string, required

## Response `200`

Success

- Contact
  - `_id` string, nullable
  - `accountId` integer
  - `name` string, nullable
  - `avatar` string, nullable
  - `created` string, date-time
  - `deleted` Deleted: Object is not deleted if field is null or { deletedStamp: null}
    - `deletedStamp` string, date-time, nullable: null means not deleted
    - `userId` integer
    - `purging` string, date-time, nullable
  - `changed` string, date-time, nullable
  - `emailSuppressed` boolean, nullable: Only used on get
  - `mobileSuppressed` boolean, nullable: Only used on get
  - `subscription` Subscription
    - `subscriptions` string[], nullable: List of SubscriptionCategory _ids
    - `snooze` string, date-time, nullable
    - `acceptEmail` boolean, nullable
    - `emailConsentGeneration` integer
    - `acceptSMS` boolean, nullable
    - `emailPendingConsent` PendingConsent
      - `pendingSince` string, date-time
      - `tokenExpiresAt` string, date-time
      - `reminderSentAt` string, date-time, nullable
      - `requestSource` string, nullable
      - `lastResentAt` string, date-time, nullable
    - `leavingReason` string, nullable
    - `leavingComment` string, nullable
    - `hasValidMobile` boolean
    - `hasValidEmail` boolean
    - `acceptedPrivacyPolicy` boolean, nullable
    - `acceptedTerms` boolean, nullable
  - `importConsent` ContactConsentAssertion[], nullable
    - `type` string, nullable
    - `accepted` boolean, nullable
    - `label` string, nullable
    - `confirm` string, nullable
    - `deny` string, nullable
    - `visible` string, nullable
    - `givenAt` string, date-time, nullable
  - `campaignFields` ContactCampaignField[], nullable
    - `flowId` string, nullable
    - `name` string, nullable
    - `source` string, nullable
    - `value` unknown
  - `version` string, nullable
  - `lastImportJobId` string, nullable
  - `externalId` string, nullable
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `email` string, nullable
  - `mobile` string, nullable
  - `title` string, nullable
  - `companyName` string, nullable
  - `address` string, nullable
  - `zip` string, nullable
  - `city` string, nullable
  - `country` string, nullable
  - `state` string, nullable
  - `leadScore` integer
  - `tagGroups` ContactTagGroup[], nullable
    - `tags` string[], nullable
    - `name` string, nullable
  - `customFields` ContactCustomField[], nullable
    - `source` string, nullable
    - `value` unknown

## Other responses

- `400`: Get contact failed
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/loopify/apis/web-api-loopify.md) · [All operations](https://skmtc.dev/loopify/apis/web-api-loopify/llms.txt) · [OpenAPI document](https://skmtc.dev/loopify/apis/web-api-loopify/revisions/68c51b11a24b?raw)
