# lookup_domain > Check whether given domains are in the corpus. Check whether given domains are in the corpus. A hit returns a revealed card (project id, domain, short description, site type, quality index, scale and growth bands, main country, niche and, when known, the payment service), the project's other domains (regional versions, mirrors) and the profile parts available for the project. This is the only tool that accepts a raw domain; a scheme, a path, a leading www and a trailing dot are stripped, other subdomains are kept and usually miss. A domain known as another address of a project in the corpus (a regional version, a mirror or a redirect) returns that project, with mirror_of naming its domain. Every distinct submitted domain is charged the base price, including those not found unless charges_empty of lookup_domain in capabilities is false; a miss returns found: false and nothing else. A hit reveals the project to your organization for as many days as reveal_ttl_days in capabilities at no reveal price, exactly as reveal_project would, and spends one unit of coverage if your organization has not seen the project this period; reveal_project adds nothing for a project found here. ## Request ```text POST https://api.megido.io/v1/tools/lookup_domain ``` Headers: `Authorization: Bearer `, and with a body `Content-Type: application/json`. `Idempotency-Key` (header, optional): A key of your own for this call, up to 200 characters, such as a UUID, that makes a retry safe: the same key with the same arguments returns the first answer, with meta.replayed: true and without charging again; with other arguments or another tool it is refused. A key is unique within your organization; values that start with task: are reserved. The tool's arguments. Its JSON Schema: ```json { "type": "object", "properties": { "domains": { "description": "Domains to look up; repeats count once; every distinct one found is charged, and one not found as well while charges_empty of lookup_domain in capabilities is true; the list is refused above batch.lookup_domain in capabilities; required unless quote_token is given", "minItems": 1, "type": "array", "items": { "description": "Domain such as example.com; a scheme, a path, a leading www and a trailing dot are stripped, other subdomains are kept", "type": "string", "maxLength": 2048 } }, "estimate": { "description": "When true, run the query but return only its composition, price and a quote_token instead of data", "type": "boolean" }, "quote_token": { "description": "Execute a previous estimate: pass the quote_token instead of the query parameters", "type": "string", "minLength": 1 } }, "additionalProperties": false, "anyOf": [ { "required": [ "quote_token" ] }, { "required": [ "domains" ] } ], "not": { "properties": { "estimate": { "const": true } }, "required": [ "estimate", "quote_token" ] } } ``` ## Answers | Status | Answer | |---|---| | 200 | The tool's answer, or with estimate: true its estimate, whose data is a Quote holding quote_token: `LookupDomainAnswer` | | 400 | The request cannot be served as sent: `bad_request`, `invalid_params`, `limit_exceeded`, `invalid_quote_token` | | 401 | No key, or a key the API does not take: `unauthorised` | | 402 | Not enough credits: `insufficient_balance` | | 403 | Not allowed for your organization or your key: `org_suspended`, `coverage_exceeded` | | 409 | In conflict with the state of a quote, the corpus or a task: `quote_expired`, `quote_spent`, `quote_outdated`, `confirmation_required`, `corpus_updated` | | 413 | The body is larger than the API takes: `bad_request` | | 415 | The body is not sent as application/json: `bad_request` | | 429 | Too many calls: `rate_limited` | | 500 | The call failed on Megido's side: `internal_error` | | 503 | Not available just now: `service_unavailable`, `lock_timeout`, `tool_unavailable` | Every error has the body `{"error": {"code": "…", "message": "…"}}` with the details of its code. The OpenAPI document holds every schema: https://api.megido.io/v1/openapi.json.