@ampeco/public-api-mcp 3.232.1 → 3.233.0

package/dist/generated/endpoints.json

@@ -4080,6 +4080,87 @@
         }
       }
     },
+    {
+      "path": "/public-api/actions/reimbursement-record/v1.0/{reimbursementRecord}/issue-credit",
+      "method": "POST",
+      "operationId": "reimbursementRecordIssueCredit",
+      "summary": "Reimbursement record / Issue credit",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Creates and returns a new reimbursement record with negated amounts that reverses the original record. A record that is already reversed, or is itself a reversing record, cannot be reversed again. This is not an accounting credit note against an invoice — reimbursement records are stateless computed entries, so a credit is the reimbursement-domain analogue of a correcting entry.",
+      "tags": [
+        "action / reimbursement record"
+      ],
+      "requestBody": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "creditReason": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 500,
+                  "description": "Reason for issuing the credit."
+                }
+              },
+              "required": [
+                "creditReason"
+              ]
+            }
+          }
+        }
+      },
+      "responses": {
+        "201": {
+          "description": "Credit record created"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "409": {
+          "description": "The request could not be completed due to a conflict with the current state of the resource. The operation may succeed if retried."
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/actions/reimbursement-report/v1.0/{reimbursementReport}/regenerate",
+      "method": "POST",
+      "operationId": "reimbursementReportRegenerate",
+      "summary": "Reimbursement report / Regenerate",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Discards the report and rebuilds it from the current reimbursement records on the next generation run. The discarded report id no longer resolves after regeneration; fetch the replacement from the reports listing (its constituent records point to it via `filter[reportId]`). Processing is asynchronous — the response returns immediately with `202 Accepted`.",
+      "tags": [
+        "action / reimbursement report"
+      ],
+      "responses": {
+        "202": {
+          "description": "Regeneration accepted"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
     {
       "path": "/public-api/actions/reservation/v1.0/{reservation}/cancel",
       "method": "POST",
@@ -33874,6 +33955,24 @@
                       "description": "The provided amount should be excluding VAT."
                     }
                   }
+                },
+                "reimbursementFees": {
+                  "type": "object",
+                  "properties": {
+                    "perSession": {
+                      "type": "number",
+                      "format": "float",
+                      "minimum": 0,
+                      "description": "Flat fee charged for every reimbursed charging session, in the contract's currency."
+                    },
+                    "perPeriod": {
+                      "type": "number",
+                      "format": "float",
+                      "minimum": 0,
+                      "description": "Flat fee charged for every reimbursement period, in the contract's currency."
+                    }
+                  },
+                  "description": "Home-charging reimbursement fees configured on the contract itself and charged to the partner for reimbursed charging sessions and reimbursement periods. Only available when the home-charging reimbursement feature is enabled for the operator. All other home-charging reimbursement settings are managed on the partner resource."
                 }
               },
               "required": [
@@ -34093,6 +34192,24 @@
                       "description": "The provided amount should be excluding VAT."
                     }
                   }
+                },
+                "reimbursementFees": {
+                  "type": "object",
+                  "properties": {
+                    "perSession": {
+                      "type": "number",
+                      "format": "float",
+                      "minimum": 0,
+                      "description": "Flat fee charged for every reimbursed charging session, in the contract's currency."
+                    },
+                    "perPeriod": {
+                      "type": "number",
+                      "format": "float",
+                      "minimum": 0,
+                      "description": "Flat fee charged for every reimbursement period, in the contract's currency."
+                    }
+                  },
+                  "description": "Home-charging reimbursement fees configured on the contract itself and charged to the partner for reimbursed charging sessions and reimbursement periods. Only available when the home-charging reimbursement feature is enabled for the operator. All other home-charging reimbursement settings are managed on the partner resource."
                 }
               },
               "required": [
@@ -34305,6 +34422,26 @@
                       "description": "The provided amount should be excluding VAT."
                     }
                   }
+                },
+                "reimbursementFees": {
+                  "type": "object",
+                  "properties": {
+                    "perSession": {
+                      "type": "number",
+                      "format": "float",
+                      "minimum": 0,
+                      "nullable": true,
+                      "description": "Flat fee charged for every reimbursed charging session, in the contract's currency. Send `null` to clear the fee; when both fees are cleared no fee entry is generated for the period. `0` is an explicit zero fee and still generates a fee entry."
+                    },
+                    "perPeriod": {
+                      "type": "number",
+                      "format": "float",
+                      "minimum": 0,
+                      "nullable": true,
+                      "description": "Flat fee charged for every reimbursement period, in the contract's currency. Send `null` to clear the fee; when both fees are cleared no fee entry is generated for the period. `0` is an explicit zero fee and still generates a fee entry."
+                    }
+                  },
+                  "description": "Home-charging reimbursement fees configured on the contract itself and charged to the partner for reimbursed charging sessions and reimbursement periods. Only applied when the home-charging reimbursement feature is enabled for the operator. All other home-charging reimbursement settings are managed on the partner resource."
                 }
               },
               "description": "All fields are optional for partial updates. Only provided fields are updated."
@@ -37626,7 +37763,7 @@
       "method": "POST",
       "operationId": "partnerInviteCreateV2_0",
       "summary": "Partner invite / Create",
-      "description": "Create a partner invite. **Experimental endpoint — not yet a stable contract.** `partner-invites/v2.0` ships as **experimental / beta**. While experimental, its schema and behaviour may change **without a version bump — including breaking changes within `v2.0` itself**. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.",
+      "description": "Create a partner invite. Reimbursement coverage of specific RFIDs and vehicles (`allow`) can be declared here only when the invited email address resolves to an existing user of the partner's operator — the listed RFIDs and vehicles must belong to that user. When no such user exists yet, coverage of specific entities is rejected with a validation error; create the invite without it and declare the covered set via the update endpoint once the invite is accepted. **Experimental endpoint — not yet a stable contract.** `partner-invites/v2.0` ships as **experimental / beta**. While experimental, its schema and behaviour may change **without a version bump — including breaking changes within `v2.0` itself**. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.",
       "tags": [
         "resource / partner invites"
       ],
@@ -37717,6 +37854,70 @@
                 "corporateBillingPolicyId": {
                   "type": "integer",
                   "description": "The corporate billing policy ID to assign. Must reference an active policy that belongs to the partner."
+                },
+                "reimbursement": {
+                  "type": "object",
+                  "properties": {
+                    "policyId": {
+                      "type": "integer",
+                      "description": "The home-charging reimbursement policy attached to the invite. Must reference an active policy that belongs to the partner or has no partner. Omitted from the response when no policy is attached."
+                    },
+                    "restrictions": {
+                      "type": "object",
+                      "properties": {
+                        "rfids": {
+                          "type": "object",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "enum": [
+                                "none",
+                                "allow"
+                              ],
+                              "description": "Discriminator for a reimbursement coverage sub-restriction: - **none**: All of the invite's attached entities of this kind are covered. - **allow**: Only the explicitly listed entities are covered."
+                            },
+                            "rfidIds": {
+                              "type": "array",
+                              "items": {
+                                "type": "integer"
+                              },
+                              "description": "The covered set of RFID IDs. Required and must be non-empty when type is `allow`; each must belong to the invited user. Listed RFIDs that are not yet attached are attached automatically, and attached RFIDs left off the list are detached. Omitted when type is `none`."
+                            }
+                          },
+                          "required": [
+                            "type"
+                          ],
+                          "description": "Reimbursement coverage for the invite's RFIDs."
+                        },
+                        "vehicles": {
+                          "type": "object",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "enum": [
+                                "none",
+                                "allow"
+                              ],
+                              "description": "Discriminator for a reimbursement coverage sub-restriction: - **none**: All of the invite's attached entities of this kind are covered. - **allow**: Only the explicitly listed entities are covered."
+                            },
+                            "vehicleIds": {
+                              "type": "array",
+                              "items": {
+                                "type": "integer"
+                              },
+                              "description": "The covered set of vehicle IDs. Required and must be non-empty when type is `allow`; each must belong to the invited user. Listed vehicles that are not yet attached are attached automatically, and attached vehicles left off the list are detached. Omitted when type is `none`."
+                            }
+                          },
+                          "required": [
+                            "type"
+                          ],
+                          "description": "Reimbursement coverage for the invite's vehicles."
+                        }
+                      },
+                      "description": "Which of the invite's RFIDs and vehicles are covered by reimbursement. On read this reports the current covered set. On write the submitted list declares the covered set: listed RFIDs/vehicles are attached automatically (they must belong to the invited user), and attached entities left off the list are detached."
+                    }
+                  },
+                  "description": "Home-charging reimbursement settings for the invite. Ignored when home-charging reimbursement is disabled."
                 }
               },
               "required": [
@@ -37851,6 +38052,71 @@
                   "type": "integer",
                   "nullable": true,
                   "description": "The corporate billing policy ID to assign. Must reference an active policy that belongs to the partner. Send `null` to clear any assigned policy; omit the field to leave the current value unchanged."
+                },
+                "reimbursement": {
+                  "type": "object",
+                  "properties": {
+                    "policyId": {
+                      "type": "integer",
+                      "nullable": true,
+                      "description": "The home-charging reimbursement policy ID to attach. Must reference an active policy that belongs to the partner or has no partner. Send `null` to detach any policy; omit the field to leave the current value unchanged."
+                    },
+                    "restrictions": {
+                      "type": "object",
+                      "properties": {
+                        "rfids": {
+                          "type": "object",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "enum": [
+                                "none",
+                                "allow"
+                              ],
+                              "description": "Discriminator for a reimbursement coverage sub-restriction: - **none**: All of the invite's attached entities of this kind are covered. - **allow**: Only the explicitly listed entities are covered."
+                            },
+                            "rfidIds": {
+                              "type": "array",
+                              "items": {
+                                "type": "integer"
+                              },
+                              "description": "The covered set of RFID IDs. Required and must be non-empty when type is `allow`; each must belong to the invited user. Listed RFIDs that are not yet attached are attached automatically, and attached RFIDs left off the list are detached. Omitted when type is `none`."
+                            }
+                          },
+                          "required": [
+                            "type"
+                          ],
+                          "description": "Reimbursement coverage for the invite's RFIDs."
+                        },
+                        "vehicles": {
+                          "type": "object",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "enum": [
+                                "none",
+                                "allow"
+                              ],
+                              "description": "Discriminator for a reimbursement coverage sub-restriction: - **none**: All of the invite's attached entities of this kind are covered. - **allow**: Only the explicitly listed entities are covered."
+                            },
+                            "vehicleIds": {
+                              "type": "array",
+                              "items": {
+                                "type": "integer"
+                              },
+                              "description": "The covered set of vehicle IDs. Required and must be non-empty when type is `allow`; each must belong to the invited user. Listed vehicles that are not yet attached are attached automatically, and attached vehicles left off the list are detached. Omitted when type is `none`."
+                            }
+                          },
+                          "required": [
+                            "type"
+                          ],
+                          "description": "Reimbursement coverage for the invite's vehicles."
+                        }
+                      },
+                      "description": "Which of the invite's RFIDs and vehicles are covered by reimbursement. On read this reports the current covered set. On write the submitted list declares the covered set: listed RFIDs/vehicles are attached automatically (they must belong to the invited user), and attached entities left off the list are detached."
+                    }
+                  },
+                  "description": "Home-charging reimbursement settings for the invite. Omit the object to leave every reimbursement setting unchanged. Ignored when home-charging reimbursement is disabled."
                 }
               },
               "description": "Partner invite update payload."
@@ -37945,6 +38211,16 @@
                   "format": "date",
                   "description": "Include partner invoices whose due date is on or before the given date (inclusive)."
                 },
+                "periodFrom": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Include partner invoices whose billing period starts on or after the given date (inclusive)."
+                },
+                "periodTo": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Include partner invoices whose billing period ends on or before the given date (inclusive)."
+                },
                 "externalId": {
                   "type": "string",
                   "maxLength": 255,
@@ -42043,7 +42319,7 @@
                 },
                 "password": {
                   "type": "string",
-                  "description": "Password meeting security requirements"
+                  "description": "Password with a minimum length of 6 characters. It must match passwordConfirmation."
                 },
                 "passwordConfirmation": {
                   "type": "string",
@@ -42181,7 +42457,7 @@
                 },
                 "password": {
                   "type": "string",
-                  "description": "New password meeting security requirements. If provided, passwordConfirmation is required."
+                  "description": "New password with a minimum length of 6 characters. If provided, it must match passwordConfirmation."
                 },
                 "passwordConfirmation": {
                   "type": "string",
@@ -47416,114 +47692,702 @@
       }
     },
     {
-      "path": "/public-api/resources/provisioning-certificates/v2.0",
-      "method": "POST",
-      "operationId": "createPcId",
-      "summary": "Provisioning Certificate / Create",
-      "description": "Create Provisioning Certificate",
+      "path": "/public-api/resources/provisioning-certificates/v2.0",
+      "method": "POST",
+      "operationId": "createPcId",
+      "summary": "Provisioning Certificate / Create",
+      "description": "Create Provisioning Certificate",
+      "tags": [
+        "resource / provisioning certificate"
+      ],
+      "requestBody": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "integer"
+                },
+                "pcId": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "vehicleType": {
+                  "type": "string",
+                  "enum": [
+                    "company",
+                    "private"
+                  ]
+                },
+                "userId": {
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "pcId",
+                "name",
+                "vehicleType",
+                "userId"
+              ]
+            }
+          }
+        }
+      },
+      "responses": {
+        "201": {
+          "description": "Provisioning Certificate created successfully"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/provisioning-certificates/v2.0/{provisioningCertificate}",
+      "method": "GET",
+      "operationId": "getPcId",
+      "summary": "Provisioning Certificate / Read",
+      "description": "Get a Provisioning Certificate",
+      "tags": [
+        "resource / provisioning certificate"
+      ],
+      "responses": {
+        "200": {
+          "description": "Provisioning Certificate returned"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/provisioning-certificates/v2.0/{provisioningCertificate}",
+      "method": "DELETE",
+      "operationId": "deletePcId",
+      "summary": "Provisioning Certificates / Delete",
+      "description": "Delete a provisioning certificate.",
+      "tags": [
+        "resource / provisioning certificate"
+      ],
+      "responses": {
+        "204": {
+          "description": "Provisioning certificate deleted successfully"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/provisioning-certificates/v2.0/{provisioningCertificate}",
+      "method": "PATCH",
+      "operationId": "updatePcId",
+      "summary": "Provisioning Certificate / Update",
+      "description": "Update a Provisioning Certificate",
+      "tags": [
+        "resource / provisioning certificate"
+      ],
+      "requestBody": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "integer"
+                },
+                "pcId": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "vehicleType": {
+                  "type": "string",
+                  "enum": [
+                    "company",
+                    "private"
+                  ]
+                },
+                "userId": {
+                  "type": "integer"
+                }
+              }
+            }
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Provisioning Certificate updated successfully"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/receipts/v2.0",
+      "method": "GET",
+      "operationId": "receiptsListing",
+      "summary": "Receipts / Listing",
+      "description": "Get all receipts",
+      "tags": [
+        "resource / receipts"
+      ],
+      "parameters": {
+        "query": {
+          "page": {
+            "description": "DEPRECATED - Sunset date: Mon, 01 Jun 2026 The page number to fetch (defaults to 1). Not used in cursor pagination. **This parameter is deprecated and will be removed on Mon, 01 Jun 2026.** Use cursor pagination instead for better performance and consistency. See the cursor parameter below for details.",
+            "type": "integer",
+            "default": 1
+          },
+          "per_page": {
+            "description": "The numbers of items to return. Used in both page and cursor pagination to declare the page size.",
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 100
+          },
+          "cursor": {
+            "description": "The cursor to fetch the next page. **Do not construct this value manually.** Use one of the following methods: - Use the value from the previous response's `links.next` to fetch the next page - Pass an empty string (e.g., `?cursor` or `?cursor=`) to initiate cursor pagination on the first page",
+            "type": "string"
+          },
+          "filter": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "operatorId": {
+                  "example": "1",
+                  "oneOf": [
+                    {
+                      "type": "string",
+                      "format": "integer"
+                    },
+                    {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "format": "integer"
+                      }
+                    }
+                  ],
+                  "description": "Filter by operator ID(s). **For operator-scoped tokens:** If provided, must match the token's operator. Returns empty results if a different operator ID is specified. **For global admin tokens:** Returns resources from the specified operator(s). Multiple IDs can be provided to filter by multiple operators. **Usage examples:** - Single operator: `?filter[operatorId]=1` - Multiple operators: `?filter[operatorId][]=1&filter[operatorId][]=2`"
+                },
+                "userId": {
+                  "type": "string",
+                  "format": "integer",
+                  "description": "Only list Receipts with a certain user id"
+                },
+                "taxId": {
+                  "type": "string",
+                  "format": "integer",
+                  "description": "Only list Receipts with specific VAT id"
+                },
+                "paymentStatus": {
+                  "type": "string",
+                  "enum": [
+                    "pending",
+                    "paid",
+                    "partially_paid"
+                  ]
+                },
+                "partnerId": {
+                  "type": "string",
+                  "format": "integer",
+                  "description": "Only list Receipts issued from a specific Partner"
+                },
+                "periodStart": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "ISO 8601 formatted date"
+                },
+                "periodEnd": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "ISO 8601 formatted date"
+                },
+                "issuedFrom": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Filter receipts issued on or after this date (inclusive)"
+                },
+                "issuedTo": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Filter receipts issued on or before this date (inclusive)"
+                }
+              }
+            }
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/receipts/v2.0/{receipt}",
+      "method": "GET",
+      "operationId": "receiptRead",
+      "summary": "Receipt / Read",
+      "description": "Get a single receipt",
+      "tags": [
+        "resource / receipts"
+      ],
+      "parameters": {
+        "path": {
+          "receipt": {
+            "description": "The Receipt ID",
+            "type": "integer",
+            "required": true
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/reimbursement-policies/v1.0",
+      "method": "GET",
+      "operationId": "reimbursementPoliciesListing",
+      "summary": "Reimbursement policies / Listing",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Get all reimbursement policies.",
+      "tags": [
+        "resource / reimbursement policies"
+      ],
+      "parameters": {
+        "query": {
+          "per_page": {
+            "description": "The number of items to return per page.",
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 100
+          },
+          "cursor": {
+            "description": "The cursor to fetch the next page. **Do not construct this value manually.** Use one of the following methods: - Use the value from the previous response's `links.next` to fetch the next page - Pass an empty string (e.g., `?cursor` or `?cursor=`) to initiate cursor pagination on the first page",
+            "type": "string"
+          },
+          "filter": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "partnerId": {
+                  "type": "integer"
+                },
+                "isActive": {
+                  "type": "boolean",
+                  "description": "When `true`, returns only policies that are active today (the current date falls within the `validityStartsOn`/`validityEndsOn` window). When `false`, returns only policies that are not active today."
+                },
+                "electricityRateSource": {
+                  "type": "string",
+                  "enum": [
+                    "policy",
+                    "charge_point"
+                  ],
+                  "description": "Origin of the per-kWh rate used to reimburse a home-charging session: - **policy**: The electricity rate linked to the policy provides the rate. `electricityRateId` is required and must belong to the same operator as the policy. - **charge_point**: The rate set by the owner on their personal charge point in the mobile app provides the rate. `electricityRateId` must not be set."
+                }
+              }
+            }
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "400": {
+          "description": "Bad Request"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/reimbursement-policies/v1.0",
+      "method": "POST",
+      "operationId": "reimbursementPolicyCreate",
+      "summary": "Reimbursement policy / Create",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Create a reimbursement policy.",
+      "tags": [
+        "resource / reimbursement policies"
+      ],
+      "requestBody": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "maxLength": 255
+                },
+                "electricityRateSource": {
+                  "type": "string",
+                  "enum": [
+                    "policy",
+                    "charge_point"
+                  ],
+                  "description": "Origin of the per-kWh rate used to reimburse a home-charging session: - **policy**: The electricity rate linked to the policy provides the rate. `electricityRateId` is required and must belong to the same operator as the policy. - **charge_point**: The rate set by the owner on their personal charge point in the mobile app provides the rate. `electricityRateId` must not be set."
+                },
+                "validityStartsOn": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Uses the YYYY-MM-DD date format."
+                },
+                "partnerId": {
+                  "type": "integer",
+                  "description": "Partner the policy is scoped to. When not set, the policy applies to every partner of the operator."
+                },
+                "partnerContractId": {
+                  "type": "integer",
+                  "description": "Partner contract the policy is scoped to. Requires `partnerId` and must belong to that partner. When not set, the policy is not scoped to a specific contract."
+                },
+                "electricityRateId": {
+                  "type": "integer",
+                  "description": "Linked electricity rate providing the reimbursement rate. Set only when `electricityRateSource` is `policy`, where it is required."
+                },
+                "validityEndsOn": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Uses the YYYY-MM-DD date format."
+                },
+                "operatorId": {
+                  "type": "integer",
+                  "example": 1,
+                  "description": "Required for global admin tokens. Omit for operator-scoped tokens (defaults to the token's operator)."
+                }
+              },
+              "required": [
+                "name",
+                "electricityRateSource",
+                "validityStartsOn"
+              ],
+              "description": "Reimbursement policy create schema. The policy defines how a home-charging session's reimbursement rate is resolved and the validity window during which it applies."
+            }
+          }
+        }
+      },
+      "responses": {
+        "201": {
+          "description": "Created"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/reimbursement-policies/v1.0/{reimbursementPolicy}",
+      "method": "GET",
+      "operationId": "reimbursementPolicyRead",
+      "summary": "Reimbursement policy / Read",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Get a single reimbursement policy.",
+      "tags": [
+        "resource / reimbursement policies"
+      ],
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/reimbursement-policies/v1.0/{reimbursementPolicy}",
+      "method": "DELETE",
+      "operationId": "reimbursementPolicyDelete",
+      "summary": "Reimbursement policy / Delete",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Delete a reimbursement policy. Deletion is rejected while the policy is attached to partner invites.",
+      "tags": [
+        "resource / reimbursement policies"
+      ],
+      "responses": {
+        "204": {
+          "description": "No content"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "409": {
+          "description": "The request could not be completed due to a conflict with the current state of the resource. The operation may succeed if retried."
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/reimbursement-policies/v1.0/{reimbursementPolicy}",
+      "method": "PATCH",
+      "operationId": "reimbursementPolicyUpdate",
+      "summary": "Reimbursement policy / Update",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Update a reimbursement policy.",
+      "tags": [
+        "resource / reimbursement policies"
+      ],
+      "requestBody": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "maxLength": 255
+                },
+                "electricityRateSource": {
+                  "type": "string",
+                  "enum": [
+                    "policy",
+                    "charge_point"
+                  ],
+                  "description": "Origin of the per-kWh rate used to reimburse a home-charging session: - **policy**: The electricity rate linked to the policy provides the rate. `electricityRateId` is required and must belong to the same operator as the policy. - **charge_point**: The rate set by the owner on their personal charge point in the mobile app provides the rate. `electricityRateId` must not be set."
+                },
+                "validityStartsOn": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Uses the YYYY-MM-DD date format."
+                },
+                "partnerId": {
+                  "type": "integer",
+                  "nullable": true,
+                  "description": "Partner the policy is scoped to. Set to `null` to apply the policy to every partner of the operator. Clearing the partner also clears `partnerContractId`."
+                },
+                "partnerContractId": {
+                  "type": "integer",
+                  "nullable": true,
+                  "description": "Partner contract the policy is scoped to. Set to `null` to remove the contract scope. Requires `partnerId` and must belong to that partner."
+                },
+                "electricityRateId": {
+                  "type": "integer",
+                  "nullable": true,
+                  "description": "Linked electricity rate providing the reimbursement rate. Required when `electricityRateSource` is `policy`; set to `null` (or omit) otherwise."
+                },
+                "validityEndsOn": {
+                  "type": "string",
+                  "format": "date",
+                  "nullable": true,
+                  "description": "Date (inclusive) until which the policy is valid, in the YYYY-MM-DD date format. Set to `null` to remove the end date. Must be after `validityStartsOn`."
+                }
+              },
+              "description": "Reimbursement policy update schema. The policy defines how a home-charging session's reimbursement rate is resolved and the validity window during which it applies."
+            }
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/reimbursement-records/v1.0",
+      "method": "GET",
+      "operationId": "reimbursementRecordsListing",
+      "summary": "Reimbursement records / Listing",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Get all reimbursement records. A record is one immutable computed reimbursement entry per charging session, including the reversing (credit) records that cancel earlier entries. For the periodic aggregates that group these records per beneficiary, payer and period, use the reimbursement reports listing.",
       "tags": [
-        "resource / provisioning certificate"
+        "resource / reimbursement records"
       ],
-      "requestBody": {
-        "required": true,
-        "content": {
-          "application/json": {
+      "parameters": {
+        "query": {
+          "per_page": {
+            "description": "The number of items to return per page.",
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 100
+          },
+          "cursor": {
+            "description": "The cursor to fetch the next page. **Do not construct this value manually.** Use one of the following methods: - Use the value from the previous response's `links.next` to fetch the next page - Pass an empty string (e.g., `?cursor` or `?cursor=`) to initiate cursor pagination on the first page",
+            "type": "string"
+          },
+          "filter": {
             "schema": {
               "type": "object",
               "properties": {
-                "id": {
+                "sessionId": {
                   "type": "integer"
                 },
-                "pcId": {
-                  "type": "string"
+                "reportId": {
+                  "type": "integer",
+                  "description": "Constituent records of a reimbursement report."
                 },
-                "name": {
-                  "type": "string"
+                "beneficiaryUserId": {
+                  "type": "integer"
                 },
-                "vehicleType": {
-                  "type": "string",
-                  "enum": [
-                    "company",
-                    "private"
-                  ]
+                "payerPartnerId": {
+                  "type": "integer"
                 },
-                "userId": {
+                "payerOperatorId": {
+                  "type": "integer"
+                },
+                "payerPartnerContractId": {
                   "type": "integer"
+                },
+                "isCredited": {
+                  "type": "boolean",
+                  "description": "true returns records that have been reversed by a credit record; false returns records not yet reversed. Reversing (credit) records themselves match false."
+                },
+                "periodFrom": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Return records whose period overlaps on or after this date."
+                },
+                "periodTo": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Return records whose period overlaps on or before this date."
                 }
-              },
-              "required": [
-                "pcId",
-                "name",
-                "vehicleType",
-                "userId"
-              ]
+              }
             }
           }
         }
       },
-      "responses": {
-        "201": {
-          "description": "Provisioning Certificate created successfully"
-        },
-        "401": {
-          "description": "Access token is missing or invalid"
-        },
-        "403": {
-          "description": "You do not have permission to perform the action"
-        },
-        "404": {
-          "description": "The record is not found"
-        },
-        "422": {
-          "description": "The payload you provided is invalid"
-        },
-        "429": {
-          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
-        }
-      }
-    },
-    {
-      "path": "/public-api/resources/provisioning-certificates/v2.0/{provisioningCertificate}",
-      "method": "GET",
-      "operationId": "getPcId",
-      "summary": "Provisioning Certificate / Read",
-      "description": "Get a Provisioning Certificate",
-      "tags": [
-        "resource / provisioning certificate"
-      ],
       "responses": {
         "200": {
-          "description": "Provisioning Certificate returned"
-        },
-        "401": {
-          "description": "Access token is missing or invalid"
-        },
-        "403": {
-          "description": "You do not have permission to perform the action"
-        },
-        "404": {
-          "description": "The record is not found"
-        },
-        "422": {
-          "description": "The payload you provided is invalid"
+          "description": "Success"
         },
-        "429": {
-          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
-        }
-      }
-    },
-    {
-      "path": "/public-api/resources/provisioning-certificates/v2.0/{provisioningCertificate}",
-      "method": "DELETE",
-      "operationId": "deletePcId",
-      "summary": "Provisioning Certificates / Delete",
-      "description": "Delete a provisioning certificate.",
-      "tags": [
-        "resource / provisioning certificate"
-      ],
-      "responses": {
-        "204": {
-          "description": "Provisioning certificate deleted successfully"
+        "400": {
+          "description": "Bad Request"
         },
         "401": {
           "description": "Access token is missing or invalid"
@@ -47531,9 +48395,6 @@
         "403": {
           "description": "You do not have permission to perform the action"
         },
-        "404": {
-          "description": "The record is not found"
-        },
         "422": {
           "description": "The payload you provided is invalid"
         },
@@ -47543,48 +48404,17 @@
       }
     },
     {
-      "path": "/public-api/resources/provisioning-certificates/v2.0/{provisioningCertificate}",
-      "method": "PATCH",
-      "operationId": "updatePcId",
-      "summary": "Provisioning Certificate / Update",
-      "description": "Update a Provisioning Certificate",
+      "path": "/public-api/resources/reimbursement-records/v1.0/{reimbursementRecord}",
+      "method": "GET",
+      "operationId": "reimbursementRecordRead",
+      "summary": "Reimbursement record / Read",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Get a single reimbursement record — the immutable computed reimbursement entry for one charging session.",
       "tags": [
-        "resource / provisioning certificate"
+        "resource / reimbursement records"
       ],
-      "requestBody": {
-        "required": true,
-        "content": {
-          "application/json": {
-            "schema": {
-              "type": "object",
-              "properties": {
-                "id": {
-                  "type": "integer"
-                },
-                "pcId": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "vehicleType": {
-                  "type": "string",
-                  "enum": [
-                    "company",
-                    "private"
-                  ]
-                },
-                "userId": {
-                  "type": "integer"
-                }
-              }
-            }
-          }
-        }
-      },
       "responses": {
         "200": {
-          "description": "Provisioning Certificate updated successfully"
+          "description": "Success"
         },
         "401": {
           "description": "Access token is missing or invalid"
@@ -47595,32 +48425,24 @@
         "404": {
           "description": "The record is not found"
         },
-        "422": {
-          "description": "The payload you provided is invalid"
-        },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
         }
       }
     },
     {
-      "path": "/public-api/resources/receipts/v2.0",
+      "path": "/public-api/resources/reimbursement-reports/v1.0",
       "method": "GET",
-      "operationId": "receiptsListing",
-      "summary": "Receipts / Listing",
-      "description": "Get all receipts",
+      "operationId": "reimbursementReportsListing",
+      "summary": "Reimbursement reports / Listing",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Get all reimbursement reports. A report is a periodic aggregate that groups the reimbursement records sharing a beneficiary, payer and period, and exposes their totals. For the per-session entries behind those totals, use the reimbursement records listing.",
       "tags": [
-        "resource / receipts"
+        "resource / reimbursement reports"
       ],
       "parameters": {
         "query": {
-          "page": {
-            "description": "DEPRECATED - Sunset date: Mon, 01 Jun 2026 The page number to fetch (defaults to 1). Not used in cursor pagination. **This parameter is deprecated and will be removed on Mon, 01 Jun 2026.** Use cursor pagination instead for better performance and consistency. See the cursor parameter below for details.",
-            "type": "integer",
-            "default": 1
-          },
           "per_page": {
-            "description": "The numbers of items to return. Used in both page and cursor pagination to declare the page size.",
+            "description": "The number of items to return per page.",
             "type": "integer",
             "minimum": 1,
             "maximum": 100,
@@ -47634,65 +48456,40 @@
             "schema": {
               "type": "object",
               "properties": {
-                "operatorId": {
-                  "example": "1",
-                  "oneOf": [
-                    {
-                      "type": "string",
-                      "format": "integer"
-                    },
-                    {
-                      "type": "array",
-                      "items": {
-                        "type": "string",
-                        "format": "integer"
-                      }
-                    }
-                  ],
-                  "description": "Filter by operator ID(s). **For operator-scoped tokens:** If provided, must match the token's operator. Returns empty results if a different operator ID is specified. **For global admin tokens:** Returns resources from the specified operator(s). Multiple IDs can be provided to filter by multiple operators. **Usage examples:** - Single operator: `?filter[operatorId]=1` - Multiple operators: `?filter[operatorId][]=1&filter[operatorId][]=2`"
-                },
-                "userId": {
+                "reimbursementType": {
                   "type": "string",
-                  "format": "integer",
-                  "description": "Only list Receipts with a certain user id"
+                  "enum": [
+                    "company",
+                    "private",
+                    "public"
+                  ],
+                  "example": "company",
+                  "description": "The home-charging reimbursement classification of the session: - **company**: The session is reimbursed as company charging. - **private**: The session is reimbursed as private charging. - **public**: The session is reimbursed as public charging."
                 },
-                "taxId": {
-                  "type": "string",
-                  "format": "integer",
-                  "description": "Only list Receipts with specific VAT id"
+                "beneficiaryUserId": {
+                  "type": "integer"
                 },
-                "paymentStatus": {
-                  "type": "string",
-                  "enum": [
-                    "pending",
-                    "paid",
-                    "partially_paid"
-                  ]
+                "payerPartnerContractId": {
+                  "type": "integer"
                 },
-                "partnerId": {
-                  "type": "string",
-                  "format": "integer",
-                  "description": "Only list Receipts issued from a specific Partner"
+                "payerPartnerId": {
+                  "type": "integer"
                 },
-                "periodStart": {
-                  "type": "string",
-                  "format": "date-time",
-                  "description": "ISO 8601 formatted date"
+                "payerOperatorId": {
+                  "type": "integer"
                 },
-                "periodEnd": {
-                  "type": "string",
-                  "format": "date-time",
-                  "description": "ISO 8601 formatted date"
+                "reimbursementPolicyId": {
+                  "type": "integer"
                 },
-                "issuedFrom": {
+                "periodFrom": {
                   "type": "string",
                   "format": "date",
-                  "description": "Filter receipts issued on or after this date (inclusive)"
+                  "description": "Return reports whose period overlaps on or after this date."
                 },
-                "issuedTo": {
+                "periodTo": {
                   "type": "string",
                   "format": "date",
-                  "description": "Filter receipts issued on or before this date (inclusive)"
+                  "description": "Return reports whose period overlaps on or before this date."
                 }
               }
             }
@@ -47703,35 +48500,32 @@
         "200": {
           "description": "Success"
         },
+        "400": {
+          "description": "Bad Request"
+        },
         "401": {
           "description": "Access token is missing or invalid"
         },
         "403": {
           "description": "You do not have permission to perform the action"
         },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
         }
       }
     },
     {
-      "path": "/public-api/resources/receipts/v2.0/{receipt}",
+      "path": "/public-api/resources/reimbursement-reports/v1.0/{reimbursementReport}",
       "method": "GET",
-      "operationId": "receiptRead",
-      "summary": "Receipt / Read",
-      "description": "Get a single receipt",
+      "operationId": "reimbursementReportRead",
+      "summary": "Reimbursement report / Read",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Get a single reimbursement report — the periodic aggregate over the reimbursement records sharing a beneficiary, payer and period. The report exposes its aggregated totals; its constituent records can be fetched from the reimbursement records listing via `filter[reportId]`.",
       "tags": [
-        "resource / receipts"
+        "resource / reimbursement reports"
       ],
-      "parameters": {
-        "path": {
-          "receipt": {
-            "description": "The Receipt ID",
-            "type": "integer",
-            "required": true
-          }
-        }
-      },
       "responses": {
         "200": {
           "description": "Success"
@@ -50676,6 +51470,11 @@
             "type": "boolean",
             "default": false
           },
+          "withDurationBreakdown": {
+            "description": "Return the charging and idle duration breakdown, including billable and grace-period seconds. Each session reports only the charging periods it owns. When an extending session is billed together with the session it extends, the grace period is consumed once along the combined timeline of both sessions, so the two responses can be summed without double counting.",
+            "type": "boolean",
+            "default": false
+          },
           "include": {
             "description": "Include additional information in the response. The following options are available:<br> - `externalAppData`: Include external application data in the response<br> - `chargingProfile`: Include the TX charging profile applied to the session in the response<br> - `vehicle`: Include the nested `vehicle` object describing the vehicle associated with the session",
             "schema": {
@@ -50848,6 +51647,91 @@
         }
       }
     },
+    {
+      "path": "/public-api/resources/sharing-invites/v1.0",
+      "method": "GET",
+      "operationId": "sharingInvitesListing",
+      "summary": "Sharing invites / Listing",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Get all sharing invites. A sharing invite represents a personal charge point owner sharing their charge point with another user.",
+      "tags": [
+        "resource / sharing invites"
+      ],
+      "parameters": {
+        "query": {
+          "per_page": {
+            "description": "The number of items to return per page.",
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 100
+          },
+          "cursor": {
+            "description": "The cursor to fetch the next page. **Do not construct this value manually.** Use one of the following methods: - Use the value from the previous response's `links.next` to fetch the next page - Pass an empty string (e.g., `?cursor` or `?cursor=`) to initiate cursor pagination on the first page",
+            "type": "string"
+          },
+          "filter": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "chargePointId": {
+                  "type": "integer"
+                },
+                "userId": {
+                  "type": "integer"
+                }
+              }
+            }
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "400": {
+          "description": "Bad Request"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/sharing-invites/v1.0/{sharingInvite}",
+      "method": "GET",
+      "operationId": "sharingInviteRead",
+      "summary": "Sharing invite / Read",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Get a single sharing invite.",
+      "tags": [
+        "resource / sharing invites"
+      ],
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
     {
       "path": "/public-api/resources/sub-operators/v1.0",
       "method": "GET",
@@ -70181,7 +71065,7 @@
   ],
   "info": {
     "title": "Public API",
-    "version": "3.232.1",
+    "version": "3.233.0",
     "description": "The Public API provides server-to-server integration capabilities for your EV charging platform.\n\n**Authentication.** Existing integrations continue to work unchanged — long-lived UUID admin tokens are sent in `Authorization: Bearer ...` with no exchange required. Two security schemes are documented for OpenAPI client tooling, both resulting in the same Bearer header at the wire level:\n   - `bearerAuth` — the token in the `Authorization: Bearer ...` header is either a long-lived UUID admin token (issued via the admin UI, used directly) or a short-lived access token previously obtained via OAuth.\n   - `oauth2ClientCredentials` - a `client_id` / `client_secret` pair should be exchanged for a short-lived access token at `/public-api/oauth/token` per RFC 6749 Section 4.4 (Client Credentials Grant), and the short-lived token should be used in the `Authorization: Bearer ...` header. The OAuth `client_secret` itself cannot be sent directly as a bearer token — it must be exchanged first.\n"
   },
   "servers": [
@@ -70195,18 +71079,18 @@
       }
     }
   ],
-  "buildTimestamp": "2026-08-17T08:28:28.680Z",
+  "buildTimestamp": "2026-08-17T10:41:20.311Z",
   "stats": {
-    "totalEndpoints": 624,
-    "originalSize": 5492259,
-    "optimizedSize": 1545702,
-    "reductionPercent": 71.86,
-    "buildDuration": 1538,
+    "totalEndpoints": 637,
+    "originalSize": 5601430,
+    "optimizedSize": 1579580,
+    "reductionPercent": 71.8,
+    "buildDuration": 900,
     "responseSchemas": {
-      "total": 624,
-      "withSchemas": 624,
-      "totalSchemaSize": 3144146,
-      "averageSchemaSize": 5039
+      "total": 637,
+      "withSchemas": 637,
+      "totalSchemaSize": 3207606,
+      "averageSchemaSize": 5035
     }
   }
 }