documents

List BLS Employment Situation release PDFs for the file viewer.

Examples

from openbb import obb
# All Employment Situation release PDFs (current + archive).
obb.bls.employment_situation.documents(provider='bls')
# Only 2024 archived releases.
obb.bls.employment_situation.documents(provider='bls', category='archived', start_date='2024-01-01', end_date='2024-12-31')

Parameters

• standard
• bls

category: str | None
Default: all
Which family of BLS Employment Situation release PDFs to enumerate.

start_date: date | None | str
Earliest publication date to include (inclusive). Applies to archived releases only.

end_date: date | None | str
Latest publication date to include (inclusive). Applies to archived releases only.

---

Returns

results: BlsEmpsitDocuments

Serializable results.

provider: str | None

Provider name.

warnings: Optional[list[Warning_]]

List of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

---

Data

• standard
• bls

name: str
Human-readable document title.

url: str
Absolute HTTPS URL to the PDF on bls.gov.

category: str
Document family (current or archived).

date: date | None | str
Release publication date.

format: str | None
File format of the document.