National Library Catalogue 1882 API (1.0.0)

Download OpenAPI specification:

REST API for accessing historical Damascus National Library catalogue data from its inception in 1882. This API provides read-only access to books, authors, genres, and endowments from the original documentary source.

books

Operations related to books in the catalogue

List all books

Retrieve a list of all books in the catalogue

query Parameters

author	integer <int64> Filter by author ID
genre	integer <int64> Filter by genre ID
endowment	integer <int64> Filter by endowment ID
manuscript	boolean Filter by manuscript status
print	boolean Filter by print status
search	string [ 1 .. 2048 ] characters Generic free-text search term to filter books
limit	integer [ 1 .. 1000 ] Default: 100 Maximum number of results to return
offset	integer >= 0 Default: 0 Number of results to skip

Responses

Response samples

200
400
500

Content type

application/json

{"items": [{"id": 1,
"number": 234,
"title": "كتاب الأغاني",
"manuscript": true,
"print": false,
"comment": "نسخة مخطوطة قديمة",
"editor_comment": "حالة جيدة، خط واضح",
"volume": "الجزء الأول",
"genre": {"id": 1,
"name": "الأدب والشعر"
},
"endowment": {"id": 1,
"name": "مكتبة الخديوي"
},
"authors": [{"id": 1,
"name": "الأصفهاني، أبو الفرج"
}
]
}
],
"total": 0,
"limit": 0,
"offset": 0
}

Get a specific book

Retrieve details of a specific book by ID

path Parameters

id

required

integer <int64>

Book ID

Responses

Response samples

200
404
500

Content type

application/json

{"id": 1,
"number": 234,
"title": "كتاب الأغاني",
"manuscript": true,
"print": false,
"comment": "نسخة مخطوطة قديمة",
"editor_comment": "حالة جيدة، خط واضح",
"volume": "الجزء الأول",
"genre": {"id": 1,
"name": "الأدب والشعر"
},
"endowment": {"id": 1,
"name": "مكتبة الخديوي"
},
"authors": [{"id": 1,
"name": "الأصفهاني، أبو الفرج"
}
]
}

authors

Operations related to authors

List all authors

Retrieve a list of all authors in the catalogue

query Parameters

search	string [ 1 .. 2048 ] characters Generic free-text search term to filter authors. The only supported field that is searched is the author's name for now.
limit	integer [ 1 .. 1000 ] Default: 100 Maximum number of results to return
offset	integer >= 0 Default: 0 Number of results to skip

Responses

Response samples

200
400
500

Content type

application/json

{"items": [{"id": 1,
"name": "الأصفهاني، أبو الفرج"
}
],
"total": 0,
"limit": 0,
"offset": 0
}

Get a specific author

Retrieve details of a specific author by ID

path Parameters

id

required

integer <int64>

Author ID

Responses

Response samples

200
404
500

Content type

application/json

{"id": 1,
"name": "الأصفهاني، أبو الفرج"
}

Get books by an author

Retrieve all books written by a specific author

path Parameters

id

required

integer <int64>

Author ID

query Parameters

limit	integer [ 1 .. 1000 ] Default: 100 Maximum number of results to return
offset	integer >= 0 Default: 0 Number of results to skip

Responses

Response samples

200
404
500

Content type

application/json

{"items": [{"id": 1,
"number": 234,
"title": "كتاب الأغاني",
"manuscript": true,
"print": false,
"comment": "نسخة مخطوطة قديمة",
"editor_comment": "حالة جيدة، خط واضح",
"volume": "الجزء الأول",
"genre": {"id": 1,
"name": "الأدب والشعر"
},
"endowment": {"id": 1,
"name": "مكتبة الخديوي"
},
"authors": [{"id": 1,
"name": "الأصفهاني، أبو الفرج"
}
]
}
],
"total": 0,
"limit": 0,
"offset": 0
}

genres

Operations related to book genres

List all genres

Retrieve a list of all genres in the catalogue

Responses

Response samples

200
500

Content type

application/json

[{"id": 1,
"name": "الأدب والشعر"
}
]

Get a specific genre

Retrieve details of a specific genre by ID

path Parameters

id

required

integer <int64>

Genre ID

Responses

Response samples

200
404
500

Content type

application/json

{"id": 1,
"name": "الأدب والشعر"
}

Get books by genre

Retrieve all books in a specific genre

path Parameters

id

required

integer <int64>

Genre ID

query Parameters

limit	integer [ 1 .. 1000 ] Default: 100 Maximum number of results to return
offset	integer >= 0 Default: 0 Number of results to skip

Responses

Response samples

200
404
500

Content type

application/json

{"items": [{"id": 1,
"number": 234,
"title": "كتاب الأغاني",
"manuscript": true,
"print": false,
"comment": "نسخة مخطوطة قديمة",
"editor_comment": "حالة جيدة، خط واضح",
"volume": "الجزء الأول",
"genre": {"id": 1,
"name": "الأدب والشعر"
},
"endowment": {"id": 1,
"name": "مكتبة الخديوي"
},
"authors": [{"id": 1,
"name": "الأصفهاني، أبو الفرج"
}
]
}
],
"total": 0,
"limit": 0,
"offset": 0
}

endowments

Operations related to library endowments

List all endowments

Retrieve a list of all endowments in the catalogue

Responses

Response samples

200
500

Content type

application/json

[{"id": 1,
"name": "مكتبة الخديوي"
}
]

Get a specific endowment

Retrieve details of a specific endowment by ID

path Parameters

id

required

integer <int64>

Endowment ID

Responses

Response samples

200
404
500

Content type

application/json

{"id": 1,
"name": "مكتبة الخديوي"
}

Get books by endowment

Retrieve all books from a specific endowment

path Parameters

id

required

integer <int64>

Endowment ID

query Parameters

limit	integer [ 1 .. 1000 ] Default: 100 Maximum number of results to return
offset	integer >= 0 Default: 0 Number of results to skip

Responses

Response samples

200
404
500

Content type

application/json

{"items": [{"id": 1,
"number": 234,
"title": "كتاب الأغاني",
"manuscript": true,
"print": false,
"comment": "نسخة مخطوطة قديمة",
"editor_comment": "حالة جيدة، خط واضح",
"volume": "الجزء الأول",
"genre": {"id": 1,
"name": "الأدب والشعر"
},
"endowment": {"id": 1,
"name": "مكتبة الخديوي"
},
"authors": [{"id": 1,
"name": "الأصفهاني، أبو الفرج"
}
]
}
],
"total": 0,
"limit": 0,
"offset": 0
}