# POST /v1/domains/card

Company card — identity, contacts, socials, technology from our crawl.

**Credits:** 10 credits per call.

**Timeout:** 60s

## Parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `domain` | string | yes | — | Domain to look up (bare hostname, lowercased). Required, max 255 chars, no spaces. |

## Request

```http
POST /v1/domains/card HTTP/1.1
Authorization: Bearer sof_live_your_key_here
Content-Type: application/json

{
  "domain": "example.com"
}
```

## Response

Wrapped in the standard envelope (id, object, created_at, elapsed_ms, cache, credits) -- documented once on The Contract. The body below is a real envelope with this endpoint's `data` shape; values vary per request, and a `…` marks an array cut short for display.

```json
{
  "id": "doma_d4e2zb4zz2feqyoydm7fte5t",
  "request_id": "req_zkft6lxwn5dhlhxfpp73em26yi",
  "object": "domain_card",
  "created_at": "2026-08-09T08:34:07Z",
  "elapsed_ms": 180,
  "cache": "miss",
  "credits": {
    "charged": 10,
    "balance": 9857
  },
  "data": {
    "domain": "example.com",
    "site_name": "Example Inc.",
    "description": "Compression socks for trail runners.",
    "logo_url": "https://example.com/logo.svg",
    "emails": [
      "hello@example.com"
    ],
    "phones": [
      "+1 415 555 0100"
    ],
    "postal_address": "548 Market St, San Francisco, CA",
    "social_profiles": {
      "linkedin": "https://linkedin.com/company/example",
      "x": "https://x.com/example"
    },
    "technology": {
      "cms": "wordpress",
      "framework": null,
      "server": "nginx",
      "hosting": "cloudflare"
    },
    "country": "US",
    "language": "en",
    "as_of": "2026-07-21"
  }
}
```

## Response fields

What each field in `data` (above) means.

| Field | Description |
| --- | --- |
| `data.domain` | The domain you requested. |
| `data.site_name` | Company/site display name, or null if not identified. |
| `data.description` | Site description, or null if not identified. |
| `data.logo_url` | URL of the site's logo, or null if not identified. |
| `data.emails` | Contact email addresses found on the site; empty array if none. |
| `data.phones` | Contact phone numbers found on the site; empty array if none. |
| `data.postal_address` | Postal address found on the site, or null if none. |
| `data.social_profiles` | Social profile URLs found on the site, keyed by platform (e.g. "linkedin", "x"); empty object if none. |
| `data.technology` | Detected technology stack. |
| `data.technology.cms` | Detected CMS, or null if not identified. |
| `data.technology.framework` | Detected web framework, or null if not identified. |
| `data.technology.server` | Detected server software, or null if not identified. |
| `data.technology.hosting` | Detected hosting provider, or null if not identified. |
| `data.country` | Detected country, or null if not identified. |
| `data.language` | Detected primary language, or null if not identified. |
| `data.as_of` | Date this card was last built from a crawl. |
