get
https://{host}/api_gateway/v1/badges/badgeMeta/getFixedWindowDetails
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
This API allows you to retrieve details of a badge's fixed windows cycle and its corresponding earned counts for customer and badge constraints.
NoteFor detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call .
Prerequisites
- Authentication: Basic or OAuth authentication
- Default access group
Resource information
| URI | /api_gateway/v1/badges/badgeMeta/getFixedWindowDetails |
| HTTP method | GET |
| Pagination | Yes |
| Batch support | NA |
Example request
curl --location 'https://eu.api.capillarytech.com/api_gateway/v1/badges/badgeMeta/getFixedWindowDetails?badgeMetaId=69381220cebb9648d8974518'Request query parameters
| Parameters | Data type | Description |
|---|---|---|
| badgeMetaId* | String | A unique identifier ("id") generated during the creation of the badge. |
| constraintType | Enum | Type of constraint. Supported values: BADGE/CUSTOMER/ALL |
| customerId | String | The customer identifier. customerId is a mandatory parameter if, constraintType is CUSTOMER or ALL and includeEarnCount is true. |
| fixedWindowCycleReferenceId | String | Fixed window cycle ID generated during the creation of the badge. |
| includeEarnCount | Boolean | Pass includeEarnCount as true to include earn counts of each cycle. |
| startDate | Date | Start date period to filter cycles. Default value: Badge start date |
| endDate | Date | End date period to filter cycles. Default value: Badge end date |
| page | Integer | Number of pages. |
| size | Integer | Size of page. |
Example response
{
"data": {
"badgeMetaId": "69381220cebb9648d8974518",
"orgId": 100737,
"startDate": 1740960000.000000000,
"startDateISO": "2025-03-03T00:00:00Z",
"endDate": 1797738400.000000000,
"endDateISO": "2026-12-20T03:46:40Z",
"fixedWindowCycles": [
{
"fixedWindowCycleReferenceId": "e6791ec9-e92f-34af-bdc3-be2607fdf82c",
"startDate": 1740960000.000000000,
"startDateISO": "2025-03-03T00:00:00Z",
"endDate": 1741132800.000000000,
"endDateISO": "2025-03-05T00:00:00Z",
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "e6791ec9-e92f-34af-bdc3-be2607fdf82c",
"startDate": 1741219200.000000000,
"startDateISO": "2025-03-06T00:00:00Z",
"endDate": 1741392000.000000000,
"endDateISO": "2025-03-08T00:00:00Z",
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "e6791ec9-e92f-34af-bdc3-be2607fdf82c",
"startDate": 1741478400.000000000,
"startDateISO": "2025-03-09T00:00:00Z",
"endDate": 1741651200.000000000,
"endDateISO": "2025-03-11T00:00:00Z",
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "e6791ec9-e92f-34af-bdc3-be2607fdf82c",
"startDate": 1741737600.000000000,
"startDateISO": "2025-03-12T00:00:00Z",
"endDate": 1741910400.000000000,
"endDateISO": "2025-03-14T00:00:00Z",
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "e6791ec9-e92f-34af-bdc3-be2607fdf82c",
"startDate": 1741996800.000000000,
"startDateISO": "2025-03-15T00:00:00Z",
"endDate": 1742169600.000000000,
"endDateISO": "2025-03-17T00:00:00Z",
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "e6791ec9-e92f-34af-bdc3-be2607fdf82c",
"startDate": 1742256000.000000000,
"startDateISO": "2025-03-18T00:00:00Z",
"endDate": 1742428800.000000000,
"endDateISO": "2025-03-20T00:00:00Z",
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "e6791ec9-e92f-34af-bdc3-be2607fdf82c",
"startDate": 1742515200.000000000,
"startDateISO": "2025-03-21T00:00:00Z",
"endDate": 1742688000.000000000,
"endDateISO": "2025-03-23T00:00:00Z",
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "e6791ec9-e92f-34af-bdc3-be2607fdf82c",
"startDate": 1742774400.000000000,
"startDateISO": "2025-03-24T00:00:00Z",
"endDate": 1742947200.000000000,
"endDateISO": "2025-03-26T00:00:00Z",
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "e6791ec9-e92f-34af-bdc3-be2607fdf82c",
"startDate": 1743033600.000000000,
"startDateISO": "2025-03-27T00:00:00Z",
"endDate": 1743206400.000000000,
"endDateISO": "2025-03-29T00:00:00Z",
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "e6791ec9-e92f-34af-bdc3-be2607fdf82c",
"startDate": 1743292800.000000000,
"startDateISO": "2025-03-30T00:00:00Z",
"endDate": 1743465600.000000000,
"endDateISO": "2025-04-01T00:00:00Z",
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
}
],
"pagination": {
"page": 0,
"size": 10,
"total": 220,
"totalPages": 22
}
},
"errors": [],
"warnings": []
}{
"data": {
"badgeMetaId": "6603ed23e4165a7993354a76",
"orgId": 4000106,
"startDate": 1709337637.192000000,
"endDate": 1709510437.192000000,
"customerId": 123,
"fixedWindowCycles": [
{
"fixedWindowCycleReferenceId": "a1350b49-eb8e-3500-9e43-01f5493c91c1",
"startDate": 1709337600.000000000,
"endDate": 1709510400.000000000,
"earnCount": 0,
"constraintType": "BADGE_FIXED_WINDOW"
}
],
"pagination": {
"page": 0,
"size": 30,
"total": 1,
"totalPages": 1
}
},
"errors": [],
"warnings": []
}{
"data": {
"badgeMetaId": "661d019d35bc684e9e727585",
"orgId": 100606,
"startDate": 1713177200.000000000,
"endDate": 1828754110.000000000,
"customerId": 62090013,
"fixedWindowCycles": [
{
"fixedWindowCycleReferenceId": "1c11e757-4f00-3bb2-8aa0-b34e25083bb3",
"startDate": 1713139200.000000000,
"endDate": 1713484800.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "1c11e757-4f00-3bb2-8aa0-b34e25083bb3",
"startDate": 1713571200.000000000,
"endDate": 1713916800.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "1c11e757-4f00-3bb2-8aa0-b34e25083bb3",
"startDate": 1714003200.000000000,
"endDate": 1714348800.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "1c11e757-4f00-3bb2-8aa0-b34e25083bb3",
"startDate": 1714435200.000000000,
"endDate": 1714435200.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "9fae3031-3abf-3936-b5df-311839c04910",
"startDate": 1714521600.000000000,
"endDate": 1717113600.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "9fae3031-3abf-3936-b5df-311839c04910",
"startDate": 1717200000.000000000,
"endDate": 1719705600.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "9fae3031-3abf-3936-b5df-311839c04910",
"startDate": 1719792000.000000000,
"endDate": 1722384000.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "9fae3031-3abf-3936-b5df-311839c04910",
"startDate": 1722470400.000000000,
"endDate": 1725062400.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "9fae3031-3abf-3936-b5df-311839c04910",
"startDate": 1725148800.000000000,
"endDate": 1727654400.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "9fae3031-3abf-3936-b5df-311839c04910",
"startDate": 1727740800.000000000,
"endDate": 1730332800.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
}
],
"pagination": {
"page": 0,
"size": 10,
"total": 48,
"totalPages": 5
}
},
"errors": [],
"warnings": []
}{
"data": {
"badgeMetaId": "661d019d35bc684e9e727585",
"orgId": 100606,
"startDate": 1713177200.000000000,
"endDate": 1828754110.000000000,
"customerId": 62090013,
"fixedWindowCycles": [
{
"fixedWindowCycleReferenceId": "1c11e757-4f00-3bb2-8aa0-b34e25083bb3",
"startDate": 1713139200.000000000,
"endDate": 1713484800.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "1c11e757-4f00-3bb2-8aa0-b34e25083bb3",
"startDate": 1713571200.000000000,
"endDate": 1713916800.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "1c11e757-4f00-3bb2-8aa0-b34e25083bb3",
"startDate": 1714003200.000000000,
"endDate": 1714348800.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
},
{
"fixedWindowCycleReferenceId": "1c11e757-4f00-3bb2-8aa0-b34e25083bb3",
"startDate": 1714435200.000000000,
"endDate": 1714435200.000000000,
"earnCount": 0,
"constraintType": "CUSTOMER_BADGE_FIXED_WINDOW"
}
],
"pagination": {
"page": 0,
"size": 10,
"total": 4,
"totalPages": 1
}
},
"errors": [],
"warnings": []
}Response parameters
| Parameter | Datatype | Description |
|---|---|---|
| data | Object | The main data container for the response. |
| badgeMetaId | String | The unique identifier for the badge metadata. |
| orgId | Integer | The unique identifier for the organization. |
| startDate | Float | The start date timestamp for the badge earning window, in epoch milliseconds timestamp format. |
| startDateISO | String | The start date timestamp (in seconds) for the badge earning window, in the ISO 8601 standard format YYYY-MM-DDTHH:MM:SS.SSSZ. |
| endDate | Float | The end date timestamp for the badge earning window, in epoch milliseconds timestamp format. |
| endDateISO | String | The end date timestamp (in seconds) for the badge earning window, in the ISO 8601 standard format YYYY-MM-DDTHH:MM:SS.SSSZ. |
| customerId | Integer | The unique identifier for the customer. |
| fixedWindowCycles | Array | An array of objects representing each fixed window cycle. |
| .fixedWindowCycleReferenceId | String | A unique reference ID for the specific fixed window cycle. |
| ..startDate | Float | The start date timestamp for the fixed window cycle, in epoch milliseconds timestamp format. |
| ..startDateISO | String | The start date timestamp for the fixed window cycle, in the ISO 8601 standard format YYYY-MM-DDTHH:MM:SS.SSSZ. |
| ..endDate | Float | The end date timestamp for the fixed window cycle, in epoch milliseconds timestamp format. |
| ..endDateISO | String | The end date timestamp (in seconds) for the fixed window cycle, in the ISO 8601 standard format YYYY-MM-DDTHH:MM:SS.SSSZ. |
| ..earnCount | Integer | The number of times the badge was earned in this cycle. |
| ..constraintType | String | The type of constraint applied to the badge earning process. |
| pagination | Object | Container for pagination information. |
| page | Integer | The current page number in the pagination sequence. |
| size | Integer | The number of items per page. |
| total | Integer | The total number of items. |
| totalPages | Integer | The total number of pages available. |
| errors | Array | An array containing any errors that occurred during the request. |
| warnings | Array | An array containing any warnings related to the request. |