get-one.mdx

title	Get Document
description	Retrieve a single document from a collection by its MongoDB ObjectId.

GET /api/data/:collectionName/:id

Fetches one document by its _id. Returns 404 if no document with that ID exists in the collection.

Required header

x-api-key: your pk_live_… or sk_live_… key.

Path parameters

The name of the collection (e.g., `posts`, `products`). The MongoDB ObjectId string of the document to retrieve (e.g., `64fd1234abcd5678ef901234`).

Query parameters

If `true`, allows retrieval of a soft-deleted document. Defaults to `false`. Without this parameter, requesting a soft-deleted document by ID will return `404 Not Found`.

Response fields

The endpoint returns the document object directly.

The unique MongoDB ObjectId string for the document. `true` if the document is in the trash. ISO date string of when the document was soft-deleted, or `null`. ISO date string of when the document was created. ISO date string of when the document was last updated. Other fields returned depend on your collection schema.

Code examples

const docId = '64fd1234abcd5678ef901234';

const res = await fetch(
  `https://api.urbackend.in/api/data/posts/${docId}?include_deleted=true`,
  {
    headers: {
      'x-api-key': 'pk_live_YOUR_KEY'
    }
  }
);

const doc = await res.json();
// doc is the retrieved document object

curl "https://api.urbackend.in/api/data/posts/64fd1234abcd5678ef901234?include_deleted=true" \
  -H "x-api-key: pk_live_YOUR_KEY"

Success response

{
  "_id": "64fd1234abcd5678ef901234",
  "title": "Why BaaS is the future",
  "body": "Content goes here...",
  "status": "published",
  "isDeleted": false,
  "deletedAt": null,
  "tags": ["tech", "development"],
  "meta": {
    "views": 105,
    "likes": 12
  },
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

Errors

Status	Cause
401 Unauthorized	Missing or invalid API key, or missing Bearer token on a private collection
404 Not Found	No document with that ID exists in the collection