# Company SaaS Stack (DNS) (`company.saas_stack`)

Infers the SaaS vendors a company uses from its public DNS alone: mail and security providers from MX, SPF and DMARC records and tools from domain-verification tokens, each with the record as evidence.

Docs: https://primaryapi.com/docs/api-reference/company/saas_stack

- Endpoint: `POST https://api.primaryapi.com/v1/run/company.saas_stack`
- Category: Enrichment · Platform: `company` · Kind: lookup · Status: live
- Price: 1 credit per call. Every call costs the same, including calls that were retried automatically.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=company.saas_stack`
- Execution: synchronous (answers 202 only if it outlives the wait window)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `domain` | string | yes |  | max 2048 chars | Company domain such as "stripe.com". A URL or email address is reduced to its domain; "www." is dropped. |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `domain` | string |  |
| `vendors` | object[] | Sorted by vendor name. |
| `vendors[].name` | string |  |
| `vendors[].category` | enum |  |
| `vendors[].confidence` | enum | high = the vendor handles live mail for the domain (MX, SPF, DMARC reports); medium = a domain-verification token, which can outlive the subscription. |
| `vendors[].evidence` | object[] |  |
| `vendors[].evidence[].recordType` | enum |  |
| `vendors[].evidence[].name` | string | DNS name that was queried, e.g. "_dmarc.stripe.com". |
| `vendors[].evidence[].value` | string | The record (or the matched part of it) that names the vendor. |
| `vendors[].evidence[].signal` | enum |  |
| `mailProvider` | string \| null | Mailbox provider from the MX hosts, when recognised. |
| `mailGateway` | string \| null | Email security gateway in front of the mailboxes, when the MX hosts show one. |
| `mx` | string[] | MX hosts, lowest preference first. |
| `spf` | object |  |
| `spf.record` | string \| null |  |
| `spf.includes` | string[] | include:, redirect= and exists: targets, in record order. |
| `dmarc` | object |  |
| `dmarc.record` | string \| null |  |
| `dmarc.policy` | enum \| null |  |
| `dmarc.reportHosts` | string[] | Domains of the rua/ruf report addresses. |
| `unrecognizedVerifications` | string[] | Keys of verification-style TXT records not in the signature table, e.g. "acme-site-verification". |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/company.saas_stack" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"stripe.com"}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "domain": "example.com",
      "vendors": [
        {
          "name": "Google Workspace",
          "category": "email",
          "confidence": "high",
          "evidence": [
            {
              "recordType": "MX",
              "name": "example.com",
              "value": "smtp.google.com",
              "signal": "mx_host"
            },
            {
              "recordType": "SPF",
              "name": "example.com",
              "value": "_spf.google.com",
              "signal": "spf_include"
            }
          ]
        },
        {
          "name": "Zoom",
          "category": "collaboration",
          "confidence": "medium",
          "evidence": [
            {
              "recordType": "TXT",
              "name": "example.com",
              "value": "ZOOM_verify_abc123",
              "signal": "verification_token"
            }
          ]
        }
      ],
      "mailProvider": "Google Workspace",
      "mailGateway": null,
      "mx": [
        "smtp.google.com"
      ],
      "spf": {
        "record": "v=spf1 include:_spf.google.com ~all",
        "includes": [
          "_spf.google.com"
        ]
      },
      "dmarc": {
        "record": "v=DMARC1; p=reject; rua=mailto:dmarc@example.com",
        "policy": "reject",
        "reportHosts": [
          "example.com"
        ]
      },
      "unrecognizedVerifications": []
    }
  },
  "provider": "PrimaryAPI",
  "credits": 1,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z"
}
```

## Pricing and reliability

- Usual price: 1 credit per call
- Price ceiling: the usual price, even when a call is retried. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=company.saas_stack`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`. See https://primaryapi.com/docs/errors.

## Notes

Reads only DNS (MX, apex TXT, _dmarc TXT and one level of SPF redirect=), never the website. A domain that does not exist is a free miss (reason domain_not_found); a domain with no matching records is a hit with an empty vendor list. Verification tokens prove a domain was verified with a vendor at some point, not that the account is still active. Outputs are stable between runs of an unchanged page (sorted lists, normalised whitespace, no timestamps), so the API can be scheduled as a monitor that fires only when the content changes.

