# reveal_project > Turn project ids into domains, along with the project's other domains (regional versions, mirrors) and, when known, the service through which… Turn project ids into domains, along with the project's other domains (regional versions, mirrors) and, when known, the service through which the project entered the corpus: a payment service or platform on whose page its visitors complete payment. Costs the base price plus the reveal price for every project your organization has not already revealed, by this tool or by a lookup_domain hit; a newly revealed project also spends one unit of coverage if it was not seen this period. A reveal lasts for the whole organization as many days as capabilities reports in reveal_ttl_days: while it holds, every later response shows the domain automatically at no further charge, revealing the project again neither charges nor extends it, and after it lapses the project is anonymous again until revealed anew. Reveal only the projects your user needs named: descriptions, bands and niches are readable without it. For a domain your user already has, lookup_domain finds and reveals its project without the reveal price. ## Request ```text POST https://api.megido.io/v1/tools/reveal_project ``` 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": { "project_ids": { "description": "Projects to reveal; refused above batch.reveal_project in capabilities; required unless quote_token is given", "minItems": 1, "type": "array", "items": { "type": "string", "pattern": "^p_[a-z2-7]{16}$", "description": "Opaque project id as returned by this server to your organization" } }, "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": [ "project_ids" ] } ], "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: `RevealProjectAnswer` | | 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.