---
title: "Get a Fiscal Calendar"
method: GET
path: "/api/v1/entities/workspaces/{workspaceId}/fiscalCalendars/{objectId}"
tags: ["Fiscal Calendars"]
---

# Get a Fiscal Calendar

`GET /api/v1/entities/workspaces/{workspaceId}/fiscalCalendars/{objectId}`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/entities/workspaces/{workspaceId}/fiscalCalendars/{objectId}`
- Auth: none declared

## Path parameters

- `workspaceId` string, required
- `objectId` string, required

## Query parameters

- `filter` string

## Headers

- `X-GDC-VALIDATE-RELATIONS` boolean

## Response `200`

Request successfully processed

- JsonApiFiscalCalendarOutDocument
  - `data` JsonApiFiscalCalendarOut, required: A custom fiscal calendar.
    - `attributes` object
      - `areRelationsValid` boolean
      - `definition` union: Calendar definition details based on the calendar type.
        - object: Calendar backed by custom fiscal calendar tables defined per data source.
          - `dataSourceTables` object, required: Custom fiscal calendar table per data source ID.
        - object: Algorithmic fiscal calendar derived by shifting the Gregorian year start.
          - `monthOffset` integer, required: Number of months the fiscal year start is shifted relative to the Gregorian year.
      - `description` string: Calendar description.
      - `enabledGranularities` object[]: Granularities available in the calendar, in drill-down order (finest to coarsest). Granularity title prefixes are localizable.
        - `granularity` 'SECOND' | 'SECOND_OF_MINUTE' | 'SECOND_OF_DAY' | 'MINUTE' | 'MINUTE_OF_HOUR' | 'MINUTE_OF_DAY' | 'HOUR' | 'HOUR_OF_DAY' | 'DAY' | 'DAY_OF_WEEK' | 'DAY_OF_MONTH' | 'DAY_OF_QUARTER' | 'DAY_OF_YEAR' | 'WEEK' | 'WEEK_OF_YEAR' | 'MONTH' | 'MONTH_OF_YEAR' | 'QUARTER' | 'QUARTER_OF_YEAR' | 'YEAR' | 'FISCAL_DAY_OF_FISCAL_WEEK' | 'FISCAL_DAY_OF_FISCAL_MONTH' | 'FISCAL_DAY_OF_FISCAL_QUARTER' | 'FISCAL_DAY_OF_FISCAL_SEMESTER' | 'FISCAL_DAY_OF_FISCAL_YEAR' | 'FISCAL_WEEK' | 'FISCAL_WEEK_OF_FISCAL_MONTH' | 'FISCAL_WEEK_OF_FISCAL_QUARTER' | 'FISCAL_WEEK_OF_FISCAL_SEMESTER' | 'FISCAL_WEEK_OF_FISCAL_YEAR' | 'FISCAL_MONTH' | 'FISCAL_MONTH_OF_FISCAL_QUARTER' | 'FISCAL_MONTH_OF_FISCAL_SEMESTER' | 'FISCAL_MONTH_OF_FISCAL_YEAR' | 'FISCAL_QUARTER' | 'FISCAL_QUARTER_OF_FISCAL_SEMESTER' | 'FISCAL_QUARTER_OF_FISCAL_YEAR' | 'FISCAL_SEMESTER' | 'FISCAL_SEMESTER_OF_FISCAL_YEAR' | 'FISCAL_YEAR', required: Fiscal granularity available in the calendar. Corresponds to the calcique granularity name.
        - `prefix` string, required: Prefix used to compose granularity titles. Can be localized via the metadata localization mechanism.
      - `tags` string[]
      - `title` string: Calendar title.
    - `id` string, required: API identifier of an object
    - `type` 'fiscalCalendar', required: Object type
  - `links` ObjectLinks
    - `self` string, uri, required: A string containing the link's URL.

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)