--- updatedAt: 2026-06-03T14:36:22.000Z agentTools: projectIndex: https://developer.personio.de/llms.txt --- # List attendance periods. List attendance periods by given filters. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Attendances API", "version": "2.0.0", "description": "Endpoints to manage attendance periods, projects and their members." }, "servers": [ { "url": "https://api.personio.de" } ], "security": [ { "BearerAuth": [] } ], "tags": [ { "name": "Attendances", "description": "Endpoints relating to the times that people work, and the rules that define this." }, { "name": "Projects", "description": "Endpoints relating to projects that can be associated with attendance periods." } ], "paths": { "/v2/attendance-periods": { "get": { "x-path-examples": { "200 LIST attendance periods": { "value": "/papi/v2/attendance-periods" }, "200 LIST attendance periods by limit": { "value": "/papi/v2/attendance-periods", "query": "limit=1" }, "200 LIST attendance periods by person id": { "value": "/papi/v2/attendance-periods", "query": "person.id=1" }, "200 LIST attendance periods by multiple person ids": { "value": "/papi/v2/attendance-periods", "query": "person.id=1,2,3" }, "200 LIST attendance periods by status": { "value": "/papi/v2/attendance-periods", "query": "status=CONFIRMED" }, "200 LIST attendance periods by project id": { "value": "/papi/v2/attendance-periods", "query": "project.id=123" }, "200 LIST attendance periods by ids": { "value": "/papi/v2/attendance-periods", "query": "id=bd242cd1-5116-41a0-99aa-c12af4837c81&id=9b620908-8252-4dbb-b406-053a9b9d8e98" }, "200 LIST attendance periods by start date from": { "value": "/papi/v2/attendance-periods", "query": "start.date_time.gte=2024-06-07T00:00:00" }, "200 LIST attendance periods by start date to": { "value": "/papi/v2/attendance-periods", "query": "start.date_time.lte=2024-06-08T00:00:00" }, "200 LIST attendance periods by end date from": { "value": "/papi/v2/attendance-periods", "query": "end.date_time.gte=2024-06-07T00:00:00" }, "200 LIST attendance periods by end date to": { "value": "/papi/v2/attendance-periods", "query": "end.date_time.lte=2024-06-08T00:00:00" }, "200 LIST attendance periods by updated date from": { "value": "/papi/v2/attendance-periods", "query": "updated_at.gte=2024-06-07T00:00:00" }, "200 LIST attendance periods by updated date to": { "value": "/papi/v2/attendance-periods", "query": "updated_at.lte=2024-06-08T00:00:00" }, "200 LIST attendance periods by attribution date from": { "value": "/papi/v2/attendance-periods", "query": "attribution_date.gte=2024-06-07" }, "200 LIST attendance periods by attribution date to": { "value": "/papi/v2/attendance-periods", "query": "attribution_date.lte=2024-06-08" }, "200 LIST attendance periods sorted by start time ascending": { "value": "/papi/v2/attendance-periods", "query": "sort=start.date_time" }, "200 LIST attendance periods sorted by multiple fields": { "value": "/papi/v2/attendance-periods", "query": "sort=status,person.id,-start.date_time,-end.date_time" }, "422 Invalid limit": { "value": "/papi/v2/attendance-periods", "query": "limit=300" }, "422 Invalid status": { "value": "/papi/v2/attendance-periods", "query": "status=notvalid" }, "403 Forbidden response": { "value": "/papi/v2/attendance-periods" } }, "tags": [ "Attendances" ], "summary": "List attendance periods.", "description": "List attendance periods by given filters.", "parameters": [ { "$ref": "#/paths/~1v2~1projects/get/parameters/0" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 100, "example": 50 }, "description": "The maximum number of attendance periods returned per request." }, { "name": "id", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "description": "Filter results matching any of the provided attendance periods' ids.\n", "example": "bd242cd1-5116-41a0-99aa-c12af4837c81" }, { "name": "person.id", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "description": "Filter results matching any of the provided persons' ids.\n", "example": "123" }, { "name": "start.date_time.gte", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/DateTimeWithoutTimezone" }, "description": "Matches attendance periods starting from (inclusive) the provided date-time.", "example": "2023-01-01T12:00:00" }, { "name": "start.date_time.lte", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/DateTimeWithoutTimezone" }, "description": "Matches attendance periods starting before or at the provided date-time.", "example": "2023-01-01T12:00:00" }, { "name": "end.date_time.lte", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/DateTimeWithoutTimezone" }, "description": "Matches attendance periods ending before or at the provided date-time.", "example": "2023-01-01T12:00:00" }, { "name": "end.date_time.gte", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/DateTimeWithoutTimezone" }, "description": "Matches attendance periods ending after or at the provided date-time.", "example": "2023-01-01T12:00:00" }, { "name": "updated_at.gte", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/UtcInstantDateTime" }, "description": "Filter out attendance periods updated before the provided date-time.", "example": "2023-01-01T12:00:00Z" }, { "name": "updated_at.lte", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/UtcInstantDateTime" }, "description": "Filter out attendance periods updated after the provided date-time.", "example": "2023-01-01T12:00:00Z" }, { "name": "attribution_date.gte", "in": "query", "required": false, "schema": { "type": "string", "format": "date" }, "description": "Matches attendance periods that are attributed to or after the provided date.", "example": "2022-12-31" }, { "name": "attribution_date.lte", "in": "query", "required": false, "schema": { "type": "string", "format": "date" }, "description": "Matches attendance periods that are attributed to or before the provided date.", "example": "2023-01-02" }, { "name": "project.id", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "description": "Matches attendance periods associated with any of the provided project IDs.", "example": "123" }, { "name": "status", "in": "query", "required": false, "description": "Status of attendance periods to filter by.", "schema": { "type": "string", "enum": [ "PENDING", "CONFIRMED", "REJECTED" ] } }, { "name": "sort", "in": "query", "required": false, "description": "Comma-separated list of fields to sort by. Prefix a field with `-` for descending order. Ascending has nulls last and DESC has nulls first Allowed fields: `person.id`, `start.date_time`, `end.date_time`, `updated_at`, `status`. Default sort order is `person.id,start.date_time,end.date_time` (all ascending).\n", "schema": { "type": "string", "pattern": "^-?(person\\.id|start\\.date_time|end\\.date_time|updated_at|status)(,-?(person\\.id|start\\.date_time|end\\.date_time|updated_at|status))*$" }, "examples": { "ascending": { "value": "start.date_time", "summary": "Sort by start time ascending" }, "descending": { "value": "-start.date_time", "summary": "Sort by start time descending" }, "multiple": { "value": "person.id,start.date_time,-end.date_time", "summary": "Sort by person ID ascending, then start time ascending, then end time descending" } } } ], "responses": { "200": { "$ref": "#/components/responses/ListAttendancePeriodResponse" }, "403": { "$ref": "#/components/responses/ForbiddenResponse" }, "422": { "$ref": "#/components/responses/ListAttendancePeriodBadRequestResponse" } } } }, "/v2/projects": { "get": { "x-path-examples": { "200 LIST projects": { "value": "/papi/v2/projects" }, "200 LIST projects by limit": { "value": "/papi/v2/projects", "query": "limit=1" }, "200 LIST projects by id": { "value": "/papi/v2/projects", "query": "id=82173" }, "200 LIST projects by multiple ids": { "value": "/papi/v2/projects", "query": "id=82173,82174" }, "200 LIST projects by name": { "value": "/papi/v2/projects", "query": "name=Project Name" }, "200 LIST projects by multiple names": { "value": "/papi/v2/projects", "query": "name=Project Name,Project Name 2" }, "200 LIST projects by status": { "value": "/papi/v2/projects", "query": "status=ACTIVE" }, "200 LIST projects by project code": { "value": "/papi/v2/projects", "query": "project_code=PRJ-1234" }, "200 LIST projects by multiple project codes": { "value": "/papi/v2/projects", "query": "project_code=PRJ-1234,PRJ-5678" }, "200 LIST projects by parent project id": { "value": "/papi/v2/projects", "query": "parent_project.id=123" }, "200 LIST projects by multiple parent project ids": { "value": "/papi/v2/projects", "query": "parent_project.id=123,456" }, "200 LIST projects with included fields": { "value": "/papi/v2/projects", "query": "include=tracked_minutes,sub_projects_tracked_minutes,sub_projects_count,tracked_periods_count" }, "200 LIST projects by top level only": { "value": "/papi/v2/projects", "query": "top_level_only=true" }, "422 Invalid include parameter": { "value": "/papi/v2/projects", "query": "include=invalid_field" }, "422 Invalid limit": { "value": "/papi/v2/projects", "query": "limit=300" }, "422 Invalid status": { "value": "/papi/v2/projects", "query": "status=notvalid" }, "403 Forbidden response": { "value": "/papi/v2/projects" } }, "tags": [ "Projects" ], "summary": "List Projects", "description": "List all projects by given filters.\n", "parameters": [ { "in": "query", "name": "cursor", "example": "cur_82sQwR2eZvKilo2duNh219Kw", "required": false, "schema": { "type": "string" }, "description": "The pagination cursor to navigate over to the next list of resources. If you pass a specific limit to your request, or you rely on the default value of the number of resources to be returned, then your subsequent call has to include the cursor in order to retrieve the next list of resources. If cursor is missing, the first page is returned." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 200 }, "description": "The maximum number of projects returned per request." }, { "name": "id", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "description": "Filter results matching any of the provided projects' ids.\n" }, { "name": "name", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "description": "Filter results matching any of the provided project names. Multiple names should be comma-separated.\n" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "ACTIVE", "ARCHIVED" ] }, "description": "The status of the projects to filter by." }, { "name": "project_code", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "description": "Filter results matching any of the provided project codes. Multiple codes should be comma-separated.\n" }, { "name": "parent_project.id", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "description": "Filter results matching any of the provided parent project ids. Multiple ids should be comma-separated.\n" }, { "name": "top_level_only", "in": "query", "required": false, "schema": { "type": "boolean" }, "description": "Filter results to only include top level projects (Projects without a parent project).\n" }, { "name": "include", "in": "query", "required": false, "style": "form", "explode": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "tracked_minutes", "sub_projects_tracked_minutes", "sub_projects_count", "tracked_periods_count" ] } }, "description": "Include additional information in the response. Multiple values should be comma-separated.\nThese fields are not included by default for performance reasons.\n" } ], "responses": { "200": { "$ref": "#/components/responses/ListProjectsResponse" }, "403": { "$ref": "#/components/responses/ForbiddenResponse" }, "422": { "$ref": "#/components/responses/ListProjectsBadRequestResponse" } } } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer" } }, "schemas": { "AttendancePeriod": { "type": "object", "description": "- Model of period entity. - Describes a period of work or break time associated with a person.", "required": [ "id", "person", "type", "approval", "start", "end", "duration", "attribution_date", "created_at", "updated_at" ], "properties": { "id": { "type": "string", "example": "123e4567-e89b-12d3-a456-426614174000" }, "person": { "type": "object", "description": "An object reference for a Person.", "required": [ "id" ], "properties": { "id": { "type": "string", "example": "1234" } } }, "type": { "description": "Field definition of attendance period types.", "type": "string", "enum": [ "WORK", "BREAK" ] }, "is_auto_generated": { "description": "Only applies to break periods. Auto generated periods are created by the system based on customer configured break rules.", "type": "boolean" }, "approval": { "type": "object", "description": "An object reference for approval details.", "required": [ "status" ], "properties": { "status": { "description": "Field definition of attendance period status.", "type": "string", "enum": [ "PENDING", "CONFIRMED", "REJECTED" ] } } }, "start": { "description": "Local Date time of when the period started. Null if exact time is unknown. Prefer [duration] if you are only interested in the period's duration.", "type": "object", "nullable": true, "required": [ "date_time" ], "properties": { "date_time": { "$ref": "#/components/schemas/DateTimeWithoutTimezone" } } }, "end": { "description": "Local Date time of when the period ended. Null for open-ended periods or if exact time is unknown. Prefer [duration] if you are only interested in the period's duration.", "type": "object", "nullable": true, "required": [ "date_time" ], "properties": { "date_time": { "$ref": "#/components/schemas/DateTimeWithoutTimezone" } } }, "duration": { "description": "Duration of the period in RFC3339. Null for open-ended periods. Minimum 0, maximum 24h, seconds always 0.", "type": "string", "format": "duration", "nullable": true, "example": "PT3H20M" }, "attribution_date": { "description": "The date that the work/break hours of this period are attributed to. This date can be different than both the date of the start and end time of this period, e.g. on overnight shifts.", "type": "string", "format": "date", "example": "2022-01-02" }, "created_at": { "description": "Date time property", "type": "string", "format": "date-time" }, "updated_at": { "description": "Date time property", "type": "string", "format": "date-time" }, "comment": { "type": "string", "nullable": true, "maxLength": 1000, "example": "An example comment." }, "legacy_break": { "description": "For old periods or created via the V1 API, breaks were modeled as a duration within the work time instead of as separate break periods. This represents a legacy break's duration, in minutes. Omitted entirely when the period has no legacy break. Never present on break type periods. The legacy break has already been deducted from the work period's duration field.", "type": "integer", "example": 30 }, "project": { "nullable": true, "description": "Project object reference by ID.", "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "example": "1234" } } } } }, "DateTimeWithoutTimezone": { "type": "string", "example": "2022-01-01T14:00:00", "description": "An RFC3339 date and timestamp without a timezone offset." }, "UtcInstantDateTime": { "type": "string", "example": "2022-01-01T14:00:00Z", "description": "An RFC3339 date and timestamp representing an instant in UTC. A trailing `Z` is accepted (but optional for backwards compatibility reasons, UTC is still assumed then); no other timezone offset is supported." } }, "responses": { "ForbiddenResponse": { "description": "Forbidden", "content": { "application/problem+json": { "schema": { "type": "object", "description": "This object represents an error response.", "properties": { "personio_trace_id": { "type": "string", "example": "aswo3f-a202lfso-312123sld-1230ddd", "description": "A unique ID that was created for this error." }, "timestamp": { "type": "string", "format": "date-time", "example": "2021-05-28T11:17:30.000Z", "description": "The timestamp of when the error occurred." }, "errors": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "example": "Not found", "description": "The title of the error." }, "detail": { "type": "string", "example": "The requested resource was not found.", "description": "A short description about the error." }, "type": { "type": "string", "format": "uri", "example": "https://developer.personio.de/reference/errors#common.requested_resource_not_found", "description": "A link to the developer hub where more information can be found for the encountered error." }, "_meta": { "type": "object", "additionalProperties": { "type": "string" } } } } } } }, "examples": { "403 Forbidden response": { "$ref": "#/components/examples/ForbiddenResponse" } } } } }, "ListAttendancePeriodResponse": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "_data": { "type": "array", "items": { "$ref": "#/components/schemas/AttendancePeriod" } }, "_meta": { "$ref": "#/components/responses/ListProjectsResponse/content/application~1json/schema/properties/_meta" } } }, "examples": { "200 LIST attendance periods": { "$ref": "#/components/examples/ListAttendancePeriods" }, "200 LIST attendance periods by limit": { "$ref": "#/components/examples/ListAttendancePeriodsByLimit" }, "200 LIST attendance periods by person id": { "$ref": "#/components/examples/ListAttendancePeriodsByPersonId" }, "200 LIST attendance periods by multiple person ids": { "$ref": "#/components/examples/ListAttendancePeriodsByMultiplePersonIds" }, "200 LIST attendance periods by status": { "$ref": "#/components/examples/ListAttendancePeriodsByStatus" }, "200 LIST attendance periods by project id": { "$ref": "#/components/examples/ListAttendancePeriodsSingleExampleResponse" }, "200 LIST attendance periods by ids": { "$ref": "#/components/examples/ListAttendancePeriodsByMultipleIds" }, "200 LIST attendance periods by start date from": { "$ref": "#/components/examples/ListAttendancePeriodsSingleExampleResponse" }, "200 LIST attendance periods by start date to": { "$ref": "#/components/examples/ListAttendancePeriodsSingleExampleResponse" }, "200 LIST attendance periods by end date from": { "$ref": "#/components/examples/ListAttendancePeriods" }, "200 LIST attendance periods by end date to": { "$ref": "#/components/examples/ListAttendancePeriods" }, "200 LIST attendance periods by updated date from": { "$ref": "#/components/examples/ListAttendancePeriodsSingleExampleResponse" }, "200 LIST attendance periods by updated date to": { "$ref": "#/components/examples/ListAttendancePeriodsSingleExampleResponse" }, "200 LIST attendance periods by attribution date from": { "$ref": "#/components/examples/ListAttendancePeriodsSingleExampleResponse" }, "200 LIST attendance periods by attribution date to": { "$ref": "#/components/examples/ListAttendancePeriodsSingleExampleResponse" }, "200 LIST attendance periods sorted by start time ascending": { "$ref": "#/components/examples/ListAttendancePeriodsSingleExampleResponse" }, "200 LIST attendance periods sorted by multiple fields": { "$ref": "#/components/examples/ListAttendancePeriodsSingleExampleResponse" } } } } }, "ListAttendancePeriodBadRequestResponse": { "description": "Invalid request", "content": { "application/problem+json": { "schema": { "$ref": "#/components/responses/ForbiddenResponse/content/application~1problem+json/schema" }, "examples": { "422 Invalid limit": { "$ref": "#/components/examples/InvalidListLimitResponse" }, "422 Invalid status": { "$ref": "#/components/examples/InvalidListStatusResponse" } } } } }, "ListProjectsResponse": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_data": { "type": "array", "items": { "$ref": "#/components/schemas/Project" } }, "_meta": { "description": "This object represents the metadata information for an object. It's a set of arbitrary key/value attributes such as `links`.", "type": "object", "readOnly": true, "properties": { "links": { "type": "object", "additionalProperties": { "description": "This objects represents a hyperlink.", "type": "object", "readOnly": true, "properties": { "href": { "type": "string", "format": "uri" } }, "additionalProperties": true }, "example": { "links": { "self": { "href": "https://api.personio.de/v2/person?cursor=" } } } } } } } }, "examples": { "200 LIST projects": { "$ref": "#/components/examples/ListProjectsResponseMultiItems" }, "200 LIST projects by limit": { "$ref": "#/components/examples/ListProjectsResponseSingleItem" }, "200 LIST projects by id": { "$ref": "#/components/examples/ListProjectsResponseSingleItem" }, "200 LIST projects by multiple ids": { "$ref": "#/components/examples/ListProjectsResponseMultiItems" }, "200 LIST projects by name": { "$ref": "#/components/examples/ListProjectsResponseSingleItem" }, "200 LIST projects by multiple names": { "$ref": "#/components/examples/ListProjectsResponseMultiItems" }, "200 LIST projects by status": { "$ref": "#/components/examples/ListProjectsResponseSingleItem" }, "200 LIST projects by project code": { "$ref": "#/components/examples/ListProjectsResponseSingleItem" }, "200 LIST projects by multiple project codes": { "$ref": "#/components/examples/ListProjectsResponseMultiItems" }, "200 LIST projects by parent project id": { "$ref": "#/components/examples/ListProjectsResponseSingleItem" }, "200 LIST projects by multiple parent project ids": { "$ref": "#/components/examples/ListProjectsResponseMultiItems" }, "200 LIST projects by top level only": { "$ref": "#/components/examples/ListProjectsByTopLevelOnly" }, "200 LIST projects with included fields": { "$ref": "#/components/examples/ListProjectsResponseWithInclude" } } } } } }, "examples": { "ForbiddenResponse": { "value": { "personio_trace_id": "aswo3f-a202lfso-312123sld-1230ddd", "timestamp": "2021-05-28T11:17:30+00:00", "errors": [ { "title": "Access denied", "detail": "Access denied to perform attendance period operations.", "type": "https://developer.personio.de/reference/errors#common.forbidden_response" } ] } }, "ListAttendancePeriods": { "value": { "_data": [ { "id": "bd242cd1-5116-41a0-99aa-c12af4837c81", "person": { "id": "1234" }, "type": "WORK", "approval": { "status": "PENDING" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": { "date_time": "2024-06-07T11:00:00" }, "duration": "PT3H", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T11:17:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } }, { "id": "e7444385-0bb5-4705-b476-e5c0ff0910dd", "person": { "id": "1234" }, "type": "BREAK", "approval": { "status": "PENDING" }, "start": { "date_time": "2024-06-07T11:00:00" }, "end": { "date_time": "2024-06-07T11:30:00" }, "duration": "PT30M", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:30:30Z", "updated_at": "2024-06-07T11:35:30Z", "is_auto_generated": false }, { "id": "9b620908-8252-4dbb-b406-053a9b9d8e98", "person": { "id": "4321" }, "type": "WORK", "approval": { "status": "PENDING" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": null, "duration": null, "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T11:17:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } } ], "_meta": { "links": { "self": { "href": "https://api.personio.de/v2/attendance-periods?cursor=35yM9aE27fsB4Joth7iDGgyk" }, "next": { "href": "https://api.personio.de/v2/attendance-periods?cursor=15sdwf2eIvLilN2dKFh211Js" } } } } }, "ListAttendancePeriodsByLimit": { "value": { "_data": [ { "id": "bd242cd1-5116-41a0-99aa-c12af4837c81", "person": { "id": "1234" }, "type": "WORK", "approval": { "status": "PENDING" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": { "date_time": "2024-06-07T11:00:00" }, "duration": "PT3H", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T11:17:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } } ], "_meta": { "links": { "self": { "href": "https://api.personio.de/v2/attendance-periods?cursor=35yM9aE27fsB4Joth7iDGgyk" }, "next": { "href": "https://api.personio.de/v2/attendance-periods?cursor=15sdwf2eIvLilN2dKFh211Js" } } } } }, "ListAttendancePeriodsByPersonId": { "value": { "_data": [ { "id": "4ff86a18-defd-4eab-bad8-947bec55ae08", "person": { "id": "1" }, "type": "WORK", "approval": { "status": "CONFIRMED" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": { "date_time": "2024-06-07T11:00:00" }, "duration": "PT3H", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T14:55:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } }, { "id": "28f2d2a2-1383-4b5f-bc82-a37e28ca95a5", "person": { "id": "1" }, "type": "BREAK", "approval": { "status": "CONFIRMED" }, "start": { "date_time": "2024-06-07T11:00:00" }, "end": { "date_time": "2024-06-07T11:30:00" }, "duration": "PT30M", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:30:30Z", "updated_at": "2024-06-07T14:55:30Z", "is_auto_generated": true }, { "id": "4ff86a18-defd-4eab-bad8-947bec55ae08", "person": { "id": "1" }, "type": "WORK", "approval": { "status": "CONFIRMED" }, "start": { "date_time": "2024-06-07T11:30:00" }, "end": { "date_time": "2024-06-07T13:45:00" }, "duration": "PT2H15M", "attribution_date": "2024-06-07", "created_at": "2024-06-07T13:45:00Z", "updated_at": "2024-06-07T14:55:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "45678" } } ], "_meta": { "links": { "self": { "href": "https://api.personio.de/v2/attendance-periods?cursor=35yM9aE27fsB4Joth7iDGgyk" }, "next": { "href": "https://api.personio.de/v2/attendance-periods?cursor=15sdwf2eIvLilN2dKFh211Js" } } } } }, "ListAttendancePeriodsByMultiplePersonIds": { "value": { "_data": [ { "id": "4ff86a18-defd-4eab-bad8-947bec55ae08", "person": { "id": "1" }, "type": "WORK", "approval": { "status": "PENDING" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": { "date_time": "2024-06-07T11:00:00" }, "duration": "PT3H", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T11:17:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } }, { "id": "0bda65f8-94a7-4010-87a2-6dd8f9e35e9a", "person": { "id": "2" }, "type": "WORK", "approval": { "status": "PENDING" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": { "date_time": "2024-06-07T11:00:00" }, "duration": "PT3H", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T11:17:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } }, { "id": "34d9c596-ab53-4ad3-afcd-26554a0d25f3", "person": { "id": "3" }, "type": "WORK", "approval": { "status": "PENDING" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": { "date_time": "2024-06-07T11:00:00" }, "duration": "PT3H", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T11:17:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } } ], "_meta": { "links": { "self": { "href": "https://api.personio.de/v2/attendance-periods?cursor=35yM9aE27fsB4Joth7iDGgyk" }, "next": { "href": "https://api.personio.de/v2/attendance-periods?cursor=15sdwf2eIvLilN2dKFh211Js" } } } } }, "ListAttendancePeriodsByStatus": { "value": { "_data": [ { "id": "8a9c52b0-a0ca-48d0-8fb6-bb8bcda949b9", "person": { "id": "14" }, "type": "WORK", "approval": { "status": "CONFIRMED" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": { "date_time": "2024-06-07T11:00:00" }, "duration": "PT3H", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T11:17:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } } ], "_meta": { "links": { "self": { "href": "https://api.personio.de/v2/attendance-periods?cursor=35yM9aE27fsB4Joth7iDGgyk" }, "next": { "href": "https://api.personio.de/v2/attendance-periods?cursor=15sdwf2eIvLilN2dKFh211Js" } } } } }, "ListAttendancePeriodsByMultipleIds": { "value": { "_data": [ { "id": "bd242cd1-5116-41a0-99aa-c12af4837c81", "person": { "id": "1" }, "type": "WORK", "approval": { "status": "PENDING" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": { "date_time": "2024-06-07T11:00:00" }, "duration": "PT3H", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T11:17:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } }, { "id": "9b620908-8252-4dbb-b406-053a9b9d8e98", "person": { "id": "2" }, "type": "WORK", "approval": { "status": "PENDING" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": { "date_time": "2024-06-07T11:00:00" }, "duration": "PT3H", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T11:17:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } } ], "_meta": { "links": { "self": { "href": "https://api.personio.de/v2/attendance-periods?cursor=35yM9aE27fsB4Joth7iDGgyk" }, "next": { "href": "https://api.personio.de/v2/attendance-periods?cursor=15sdwf2eIvLilN2dKFh211Js" } } } } }, "ListAttendancePeriodsSingleExampleResponse": { "value": { "_data": [ { "id": "8a9c52b0-a0ca-48d0-8fb6-bb8bcda949b9", "person": { "id": "14" }, "type": "WORK", "approval": { "status": "CONFIRMED" }, "start": { "date_time": "2024-06-07T08:00:00" }, "end": { "date_time": "2024-06-07T11:00:00" }, "duration": "PT3H", "attribution_date": "2024-06-07", "created_at": "2024-06-07T11:17:30Z", "updated_at": "2024-06-07T11:17:30Z", "comment": "Comment associated with this attendance period.", "is_auto_generated": false, "project": { "id": "82173" } } ], "_meta": { "links": { "self": { "href": "https://api.personio.de/v2/attendance-periods?cursor=35yM9aE27fsB4Joth7iDGgyk" }, "next": { "href": "https://api.personio.de/v2/attendance-periods?cursor=15sdwf2eIvLilN2dKFh211Js" } } } } }, "InvalidListLimitResponse": { "value": { "personio_trace_id": "aswo3f-a202lfso-312123sld-1230ddd", "timestamp": "2021-05-28T11:17:30Z", "errors": [ { "title": "Invalid limit parameter.", "detail": "The provided value for the 'limit' parameter is invalid. Please ensure that the value is an integer within the range 1-200." } ] } }, "InvalidListStatusResponse": { "value": { "personio_trace_id": "aswo3f-a202lfso-312123sld-1230ddd", "timestamp": "2021-05-28T11:17:30Z", "errors": [ { "title": "Invalid status parameter.", "detail": "The provided value for the 'status' parameter is invalid. Please ensure that the value is one of: [PENDING, CONFIRMED, REJECTED]." } ] } } } } } ```