Get collection items by id

Get all resources that belong to an existing collection by collection id.

Path Parameters

collectionId string

Query Parameters

sortBy string

Possible values: [recentlyAdded, verseKey]

Sort the collection items either by the time they were added at descendingly or by Ayah key.

last integer

Possible values: >= 1 and <= 20

The number of items to be fetched. Should be used together with before

first object

Possible values: >= 1 and <= 20

The number of items to be fetched.

after object

The cursor after which you want to get the next page of items. Should be used together with first

before object

The cursor before which the previous page of items will be fetched. Should be used together with last

Responses

• 200
• 403
• 404
• 422
• 500

---

Request has been handled successfully.

application/json

Schema

Example (from schema)

---

Schema

success boolean
data object
collection object
id string required
updatedAt date-time required
name string required
bookmarks object[]
Array [
id string required
createdAt date-time required
type string required
key integer required
verseNumber integer
group string
]
pagination object
startCursor string
endCursor string
hasNextPage boolean
hasPreviousPage boolean

{
  "success": true,
  "data": {
    "collection": {
      "id": "cm4v8amgb00077iq92hp7h6eo",
      "updatedAt": "2023-01-21T07:28:13.023Z",
      "name": "Woman in Quran"
    },
    "bookmarks": [
      {
        "id": "cm4v8amcx00057iq92odo9hzv",
        "createdAt": "2023-01-21T07:28:13.023Z",
        "type": "ayah",
        "key": 1,
        "verseNumber": 5,
        "group": "string"
      }
    ]
  },
  "pagination": {
    "startCursor": "cm4v8am0o00027iq97l0sbkl4",
    "endCursor": "cm4v8am0p00037iq9dwbo61rg",
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}

Forbidden error. Can either be due to access token not being passed, having been expired or the caller trying to access a resource without enough permissions.

application/json

Schema

Example (from schema)

---

Schema

success boolean
error object
code string
message string

{
  "success": false,
  "error": {
    "code": "ForbiddenError",
    "message": "Token expired"
  }
}

Not Found. The resource being accessed does not exist.

application/json

Schema

Example (from schema)

---

Schema

success boolean
error object
code string
message string

{
  "success": false,
  "error": {
    "code": "NotFoundError",
    "message": "The resource you're looking for does not exist"
  }
}

Validation Error. The request includes one or more invalid params. Please check the request params and try again.

application/json

Schema

Example (from schema)

---

Schema

success boolean
error object
code string
message string

{
  "success": false,
  "error": {
    "code": "ValidationError",
    "message": "`id` is required"
  }
}

Server Error. Something went wrong, try again later.

application/json

Schema

Example (from schema)

---

Schema

success boolean
error object
code string
message string

{
  "success": false,
  "error": {
    "code": "ServerError",
    "message": "Something went wrong"
  }
}

Loading...