--- title: "Get a resource" description: "Retrieve one resource and its import status. Poll it after an import until the status is ready or failed." canonical: "https://lookio.app/docs/api/resources/get-resource" updated: "2026-10-17" --- # Get a resource Requires `resources:read`. Poll this endpoint after an import. `ready` and `failed` are final: stop polling when you see either. For `failed`, read `status_detail`, fix the cause and [re-index](/docs/api/resources/reindex-resource). A resource of another workspace answers the same `resource_not_found` as one that does not exist. ```http GET https://api.lookio.app/v1/resources/{resource_id} ``` ## Authorizations - `Authorization` (bearer, in header, required) ## Path parameters - `resource_id` (`string`, required, pattern: `^res_[abcdefghjkmnpqrstuvwxyz23456789]{12}$`) ## Query parameters - `wait` (`boolean | enum`): Wait up to 15 seconds for reading and indexing to finish before returning. Short texts, files and pages usually come back `ready` (or `failed`) in one call; larger imports return their current status (`queued` or `processing`) when the window ends, never an error. ## Response **200**: Retrieve a resource - `data` (`object`, required) - `data.id` (`string`, required, pattern: `^res_[abcdefghjkmnpqrstuvwxyz23456789]{12}$`) - `data.title` (`string`, required) - `data.type` (`enum`, required, one of: `text, file, url, site`) - `data.status` (`enum`, required, one of: `queued, processing, ready, failed, stale, ready_simulated`): `queued` and `processing`: being read and indexed (pass `wait=true` or poll until it changes). `ready`: searchable. `failed`: see `status_detail`, then fix and call reindex. - `data.status_detail` (`string,null`, required) - `data.tags` (`string[]`, required) - `data.source_url` (`string,null`, required): The page or site address, for `url` and `site` resources. - `data.source` (`string,null`, required): Where it comes from, as shown with its citations. - `data.site` (`object | null`, required): A site's page rules and schedule; null for other types. - `data.site.rules` (`object`, required, default: `{"include":[],"exclude":[],"excluded_urls":[]}`) - `data.site.rules.include` (`string[]`, required, default: `[]`, items: `≤ 50 items`): Path patterns to keep, such as `/docs/**`. `*` is one level, `**` everything below. Empty keeps the whole site. - `data.site.rules.exclude` (`string[]`, required, default: `[]`, items: `≤ 50 items`): Path patterns to leave out, such as `/blog/**`. - `data.site.rules.regex` (`string`, length: `≤ 500 chars`): Advanced: a regular expression on the path; matching pages are left out. - `data.site.rules.excluded_urls` (`string[]`, required, default: `[]`, items: `≤ 5000 items`): Single pages to leave out, by full address. - `data.site.schedule` (`string`, required, length: `≤ 40 chars`, pattern: `^(?:manual|daily|weekly|monthly|every_\d+_(?:day|days|week|weeks|month|months))$`): `manual` syncs only on request. Recurring schedules accept `daily`, `weekly`, `monthly`, or `every_N_days`, `every_N_weeks` and `every_N_months` (1-90 days, 1-52 weeks, 1-12 months). Recurring schedules require a paid plan. - `data.site.last_synced_at` (`string,null`, required) - `data.created_at` (`string`, required) - `data.updated_at` (`string`, required) - `request_id` (`string`, required) ```json { "data": { "id": "res_thk6smb5nvts", "title": "Refund policy", "type": "text", "status": "ready", "status_detail": null, "tags": [ "legal", "faq" ], "source_url": null, "source": "Employee handbook, 2026 edition", "site": null, "created_at": "2026-10-12T09:30:00.000Z", "updated_at": "2026-10-12T09:30:00.000Z" }, "request_id": "req_01K9X7M2Q4" } ``` **400**: Possible codes: invalid_request, unknown_field, invalid_parameter, invalid_cursor - `error` (`object`, required) - `error.type` (`string`, required) - `error.code` (`string`, required) - `error.message` (`string`, required) - `error.param` (`string`) - `error.docs_url` (`string`, required) - `error.action_url` (`string`) - `request_id` (`string`, required) ```json { "error": { "type": "", "code": "", "message": "", "param": "", "docs_url": "", "action_url": "" }, "request_id": "" } ``` **401**: Possible codes: authentication_required, invalid_api_key, api_key_expired, api_key_revoked, invalid_access_key - `error` (`object`, required) - `error.type` (`string`, required) - `error.code` (`string`, required) - `error.message` (`string`, required) - `error.param` (`string`) - `error.docs_url` (`string`, required) - `error.action_url` (`string`) - `request_id` (`string`, required) ```json { "error": { "type": "", "code": "", "message": "", "param": "", "docs_url": "", "action_url": "" }, "request_id": "" } ``` **403**: Possible codes: insufficient_scope, feature_not_available, admin_required, permission_denied - `error` (`object`, required) - `error.type` (`string`, required) - `error.code` (`string`, required) - `error.message` (`string`, required) - `error.param` (`string`) - `error.docs_url` (`string`, required) - `error.action_url` (`string`) - `request_id` (`string`, required) ```json { "error": { "type": "", "code": "", "message": "", "param": "", "docs_url": "", "action_url": "" }, "request_id": "" } ``` **404**: Possible codes: resource_not_found - `error` (`object`, required) - `error.type` (`string`, required) - `error.code` (`string`, required) - `error.message` (`string`, required) - `error.param` (`string`) - `error.docs_url` (`string`, required) - `error.action_url` (`string`) - `request_id` (`string`, required) ```json { "error": { "type": "", "code": "", "message": "", "param": "", "docs_url": "", "action_url": "" }, "request_id": "" } ``` **429**: Possible codes: rate_limited - `error` (`object`, required) - `error.type` (`string`, required) - `error.code` (`string`, required) - `error.message` (`string`, required) - `error.param` (`string`) - `error.docs_url` (`string`, required) - `error.action_url` (`string`) - `request_id` (`string`, required) ```json { "error": { "type": "", "code": "", "message": "", "param": "", "docs_url": "", "action_url": "" }, "request_id": "" } ``` **500**: Possible codes: internal_error - `error` (`object`, required) - `error.type` (`string`, required) - `error.code` (`string`, required) - `error.message` (`string`, required) - `error.param` (`string`) - `error.docs_url` (`string`, required) - `error.action_url` (`string`) - `request_id` (`string`, required) ```json { "error": { "type": "", "code": "", "message": "", "param": "", "docs_url": "", "action_url": "" }, "request_id": "" } ``` **Example request** ```bash curl --request GET \ --url 'https://api.lookio.app/v1/resources/' \ --header 'Authorization: ' ```