@ampeco/public-api-mcp 3.245.3 → 3.246.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "totalEndpoints": 640,
3
- "originalSize": 5796134,
4
- "optimizedSize": 1619628,
5
- "reductionPercent": 72.06,
6
- "buildDuration": 1555,
3
+ "originalSize": 5825490,
4
+ "optimizedSize": 1630992,
5
+ "reductionPercent": 72,
6
+ "buildDuration": 1752,
7
7
  "responseSchemas": {
8
8
  "total": 640,
9
9
  "withSchemas": 640,
10
- "totalSchemaSize": 3303477,
11
- "averageSchemaSize": 5162
10
+ "totalSchemaSize": 3315541,
11
+ "averageSchemaSize": 5181
12
12
  }
13
13
  }
@@ -52495,7 +52495,7 @@
52495
52495
  "method": "GET",
52496
52496
  "operationId": "subOperatorsListing",
52497
52497
  "summary": "Sub-operators / Listing",
52498
- "description": "Get all sub-operators. Returns sub-operators ordered by businessName ascending by default. Uses cursor-based pagination.",
52498
+ "description": "Get all sub-operators. Returns sub-operators ordered by their English (en) name ascending. The order is fixed and cannot be changed. Uses cursor-based pagination.",
52499
52499
  "tags": [
52500
52500
  "resource / sub operators"
52501
52501
  ],
@@ -52555,7 +52555,7 @@
52555
52555
  },
52556
52556
  "name": {
52557
52557
  "type": "string",
52558
- "description": "Filter by sub-operator name (partial match)"
52558
+ "description": "Filter by sub-operator name (partial match against the English (en) name only)"
52559
52559
  },
52560
52560
  "businessName": {
52561
52561
  "type": "string",
@@ -52563,7 +52563,7 @@
52563
52563
  },
52564
52564
  "region": {
52565
52565
  "type": "string",
52566
- "description": "Filter by region for countries without predefined states (partial match)"
52566
+ "description": "Filter by region for countries without predefined states (partial match against the English (en) region only)"
52567
52567
  },
52568
52568
  "lastUpdatedAfter": {
52569
52569
  "type": "string",
@@ -52615,11 +52615,6 @@
52615
52615
  "schema": {
52616
52616
  "type": "object",
52617
52617
  "properties": {
52618
- "name": {
52619
- "type": "string",
52620
- "maxLength": 255,
52621
- "description": "Display name of the sub-operator"
52622
- },
52623
52618
  "businessName": {
52624
52619
  "type": "string",
52625
52620
  "maxLength": 255,
@@ -52896,11 +52891,6 @@
52896
52891
  ],
52897
52892
  "description": "ISO 3166-1 alpha-2 country code"
52898
52893
  },
52899
- "city": {
52900
- "type": "string",
52901
- "maxLength": 255,
52902
- "description": "City name"
52903
- },
52904
52894
  "state": {
52905
52895
  "anyOf": [
52906
52896
  {
@@ -53074,21 +53064,11 @@
53074
53064
  ],
53075
53065
  "description": "When the selected country is one of US, AU, CA, UM or RO"
53076
53066
  },
53077
- "region": {
53078
- "type": "string",
53079
- "nullable": true,
53080
- "description": "When country is not in US, AU, CA, UM or RO, you can provide the region"
53081
- },
53082
53067
  "postcode": {
53083
53068
  "type": "string",
53084
53069
  "maxLength": 255,
53085
53070
  "description": "Postal/ZIP code"
53086
53071
  },
53087
- "address": {
53088
- "type": "string",
53089
- "maxLength": 255,
53090
- "description": "Street address"
53091
- },
53092
53072
  "contactPerson": {
53093
53073
  "type": "string",
53094
53074
  "maxLength": 255,
@@ -53145,12 +53125,117 @@
53145
53125
  "type": "integer"
53146
53126
  },
53147
53127
  "description": "List of associated partner IDs"
53128
+ },
53129
+ "translatedName": {
53130
+ "type": "array",
53131
+ "items": {
53132
+ "type": "object",
53133
+ "properties": {
53134
+ "locale": {
53135
+ "type": "string",
53136
+ "description": "valid locale configured for the tenant"
53137
+ },
53138
+ "translation": {
53139
+ "type": "string",
53140
+ "maxLength": 255
53141
+ }
53142
+ },
53143
+ "required": [
53144
+ "locale",
53145
+ "translation"
53146
+ ]
53147
+ },
53148
+ "minItems": 1,
53149
+ "description": "Display name of the sub-operator per locale. Whenever this field is submitted — on both create and update — the array must contain an `en` entry. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the name: locales absent from the array are cleared. Omit the field to leave every existing locale untouched. An empty array is rejected on both create and update — the name cannot be cleared. Cannot be provided together with the deprecated `name`."
53150
+ },
53151
+ "translatedAddress": {
53152
+ "type": "array",
53153
+ "items": {
53154
+ "type": "object",
53155
+ "properties": {
53156
+ "locale": {
53157
+ "type": "string",
53158
+ "description": "valid locale configured for the tenant"
53159
+ },
53160
+ "translation": {
53161
+ "type": "string",
53162
+ "maxLength": 255
53163
+ }
53164
+ },
53165
+ "required": [
53166
+ "locale",
53167
+ "translation"
53168
+ ]
53169
+ },
53170
+ "description": "Street address of the sub-operator per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the address: locales absent from the array are cleared. Omit the field to leave every existing locale untouched; submit an empty array to clear them all. Cannot be provided together with the deprecated `address`."
53171
+ },
53172
+ "translatedCity": {
53173
+ "type": "array",
53174
+ "items": {
53175
+ "type": "object",
53176
+ "properties": {
53177
+ "locale": {
53178
+ "type": "string",
53179
+ "description": "valid locale configured for the tenant"
53180
+ },
53181
+ "translation": {
53182
+ "type": "string",
53183
+ "maxLength": 255
53184
+ }
53185
+ },
53186
+ "required": [
53187
+ "locale",
53188
+ "translation"
53189
+ ]
53190
+ },
53191
+ "description": "City of the sub-operator per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the city: locales absent from the array are cleared. Omit the field to leave every existing locale untouched; submit an empty array to clear them all. Cannot be provided together with the deprecated `city`."
53192
+ },
53193
+ "translatedRegion": {
53194
+ "type": "array",
53195
+ "items": {
53196
+ "type": "object",
53197
+ "properties": {
53198
+ "locale": {
53199
+ "type": "string",
53200
+ "description": "valid locale configured for the tenant"
53201
+ },
53202
+ "translation": {
53203
+ "type": "string",
53204
+ "maxLength": 255
53205
+ }
53206
+ },
53207
+ "required": [
53208
+ "locale",
53209
+ "translation"
53210
+ ]
53211
+ },
53212
+ "description": "Region of the sub-operator per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the region: locales absent from the array are cleared. Omit the field to leave every existing locale untouched; submit an empty array to clear them all. Rejected when the sub-operator's country supports states (US, CA, AU, UM, RO) — `state` applies instead and is not translatable. Cannot be provided together with the deprecated `region`."
53213
+ },
53214
+ "name": {
53215
+ "type": "string",
53216
+ "maxLength": 255,
53217
+ "description": "**This property is deprecated. Use `translatedName` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedName`. Display name of the sub-operator."
53218
+ },
53219
+ "city": {
53220
+ "type": "string",
53221
+ "maxLength": 255,
53222
+ "description": "**This property is deprecated. Use `translatedCity` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedCity`. City name"
53223
+ },
53224
+ "region": {
53225
+ "type": "string",
53226
+ "nullable": true,
53227
+ "description": "When country is not in US, AU, CA, UM or RO, you can provide the region"
53228
+ },
53229
+ "address": {
53230
+ "type": "string",
53231
+ "maxLength": 255,
53232
+ "description": "**This property is deprecated. Use `translatedAddress` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedAddress`. Street address"
53148
53233
  }
53149
53234
  },
53150
53235
  "required": [
53151
- "name",
53152
53236
  "businessName"
53153
- ]
53237
+ ],
53238
+ "description": "At least one of `name` or `translatedName` must be provided. Supplying both is rejected with a `422` response. When `translatedName` is used it must carry an `en` entry. A deprecated field and its `translated` sibling are mutually exclusive: `name`/`translatedName`, `address`/`translatedAddress`, `city`/`translatedCity` and `region`/`translatedRegion` may each be sent one at a time, never both."
53154
53239
  }
53155
53240
  }
53156
53241
  }
@@ -53258,10 +53343,95 @@
53258
53343
  "schema": {
53259
53344
  "type": "object",
53260
53345
  "properties": {
53346
+ "translatedName": {
53347
+ "type": "array",
53348
+ "items": {
53349
+ "type": "object",
53350
+ "properties": {
53351
+ "locale": {
53352
+ "type": "string",
53353
+ "description": "valid locale configured for the tenant"
53354
+ },
53355
+ "translation": {
53356
+ "type": "string",
53357
+ "maxLength": 255
53358
+ }
53359
+ },
53360
+ "required": [
53361
+ "locale",
53362
+ "translation"
53363
+ ]
53364
+ },
53365
+ "minItems": 1,
53366
+ "description": "Display name of the sub-operator per locale. Whenever this field is submitted — on both create and update — the array must contain an `en` entry. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the name: locales absent from the array are cleared. Omit the field to leave every existing locale untouched. An empty array is rejected on both create and update — the name cannot be cleared. Cannot be provided together with the deprecated `name`."
53367
+ },
53368
+ "translatedAddress": {
53369
+ "type": "array",
53370
+ "items": {
53371
+ "type": "object",
53372
+ "properties": {
53373
+ "locale": {
53374
+ "type": "string",
53375
+ "description": "valid locale configured for the tenant"
53376
+ },
53377
+ "translation": {
53378
+ "type": "string",
53379
+ "maxLength": 255
53380
+ }
53381
+ },
53382
+ "required": [
53383
+ "locale",
53384
+ "translation"
53385
+ ]
53386
+ },
53387
+ "description": "Street address of the sub-operator per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the address: locales absent from the array are cleared. Omit the field to leave every existing locale untouched; submit an empty array to clear them all. Cannot be provided together with the deprecated `address`."
53388
+ },
53389
+ "translatedCity": {
53390
+ "type": "array",
53391
+ "items": {
53392
+ "type": "object",
53393
+ "properties": {
53394
+ "locale": {
53395
+ "type": "string",
53396
+ "description": "valid locale configured for the tenant"
53397
+ },
53398
+ "translation": {
53399
+ "type": "string",
53400
+ "maxLength": 255
53401
+ }
53402
+ },
53403
+ "required": [
53404
+ "locale",
53405
+ "translation"
53406
+ ]
53407
+ },
53408
+ "description": "City of the sub-operator per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the city: locales absent from the array are cleared. Omit the field to leave every existing locale untouched; submit an empty array to clear them all. Cannot be provided together with the deprecated `city`."
53409
+ },
53410
+ "translatedRegion": {
53411
+ "type": "array",
53412
+ "items": {
53413
+ "type": "object",
53414
+ "properties": {
53415
+ "locale": {
53416
+ "type": "string",
53417
+ "description": "valid locale configured for the tenant"
53418
+ },
53419
+ "translation": {
53420
+ "type": "string",
53421
+ "maxLength": 255
53422
+ }
53423
+ },
53424
+ "required": [
53425
+ "locale",
53426
+ "translation"
53427
+ ]
53428
+ },
53429
+ "description": "Region of the sub-operator per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the region: locales absent from the array are cleared. Omit the field to leave every existing locale untouched; submit an empty array to clear them all. Rejected when the sub-operator's country supports states (US, CA, AU, UM, RO) — `state` applies instead and is not translatable. Cannot be provided together with the deprecated `region`."
53430
+ },
53261
53431
  "name": {
53262
53432
  "type": "string",
53263
53433
  "maxLength": 255,
53264
- "description": "Display name of the sub-operator. Must be unique within the operator scope."
53434
+ "description": "**This property is deprecated. Use `translatedName` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedName`. Display name of the sub-operator."
53265
53435
  },
53266
53436
  "businessName": {
53267
53437
  "type": "string",
@@ -53548,7 +53718,7 @@
53548
53718
  "type": "string",
53549
53719
  "maxLength": 255,
53550
53720
  "nullable": true,
53551
- "description": "City name. Send null to clear."
53721
+ "description": "**This property is deprecated. Use `translatedCity` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedCity`. City name. Send null to clear the English (`en`) value only — every other locale is left untouched. Use `translatedCity` to clear other locales."
53552
53722
  },
53553
53723
  "state": {
53554
53724
  "anyOf": [
@@ -53738,7 +53908,7 @@
53738
53908
  "type": "string",
53739
53909
  "maxLength": 255,
53740
53910
  "nullable": true,
53741
- "description": "Street address. Send null to clear."
53911
+ "description": "**This property is deprecated. Use `translatedAddress` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedAddress`. Street address. Send null to clear the English (`en`) value only — every other locale is left untouched. Use `translatedAddress` to clear other locales."
53742
53912
  },
53743
53913
  "contactPerson": {
53744
53914
  "type": "string",
@@ -53802,7 +53972,8 @@
53802
53972
  },
53803
53973
  "description": "List of partner IDs to associate. Replaces existing associations."
53804
53974
  }
53805
- }
53975
+ },
53976
+ "description": "A deprecated field and its `translated` sibling are mutually exclusive: `name`/`translatedName`, `address`/`translatedAddress`, `city`/`translatedCity` and `region`/`translatedRegion` may each be sent one at a time, never both. Supplying both is rejected with a `422` response."
53806
53977
  }
53807
53978
  }
53808
53979
  }
@@ -62823,6 +62994,45 @@
62823
62994
  "paymentMethod": {
62824
62995
  "type": "object",
62825
62996
  "properties": {
62997
+ "cardType": {
62998
+ "type": "string",
62999
+ "enum": [
63000
+ "credit",
63001
+ "debit",
63002
+ "prepaid"
63003
+ ],
63004
+ "description": "Card category. Allowed values: - `credit` - Credit card. - `debit` - Debit card. - `prepaid` - Prepaid card."
63005
+ },
63006
+ "bin": {
63007
+ "type": "string",
63008
+ "minLength": 1,
63009
+ "maxLength": 255,
63010
+ "description": "Bank identification number recorded for this transaction (first 6-8 digits). A value consisting only of whitespace or invisible characters is rejected."
63011
+ },
63012
+ "fingerprint": {
63013
+ "type": "string",
63014
+ "minLength": 1,
63015
+ "maxLength": 255,
63016
+ "description": "Unique card fingerprint recorded for this transaction for cross-channel and cross-PSP card identification. Carries the Payment Account Reference (PAR) where the PSP provides it. A value consisting only of whitespace or invisible characters is rejected."
63017
+ },
63018
+ "acquirerName": {
63019
+ "type": "string",
63020
+ "minLength": 1,
63021
+ "maxLength": 255,
63022
+ "description": "Name of the acquiring bank recorded for this transaction. A value consisting only of whitespace or invisible characters is rejected."
63023
+ },
63024
+ "issuerName": {
63025
+ "type": "string",
63026
+ "minLength": 1,
63027
+ "maxLength": 255,
63028
+ "description": "Name of the card issuing bank recorded for this transaction. A value consisting only of whitespace or invisible characters is rejected."
63029
+ },
63030
+ "issuerCode": {
63031
+ "type": "string",
63032
+ "minLength": 1,
63033
+ "maxLength": 255,
63034
+ "description": "Code of the card issuing bank recorded for this transaction. A value consisting only of whitespace or invisible characters is rejected."
63035
+ },
62826
63036
  "methodType": {
62827
63037
  "type": "string",
62828
63038
  "enum": [
@@ -63422,6 +63632,51 @@
63422
63632
  "paymentMethod": {
63423
63633
  "type": "object",
63424
63634
  "properties": {
63635
+ "cardType": {
63636
+ "type": "string",
63637
+ "enum": [
63638
+ "credit",
63639
+ "debit",
63640
+ "prepaid"
63641
+ ],
63642
+ "nullable": true,
63643
+ "description": "Card category. Allowed values: - `credit` - Credit card. - `debit` - Debit card. - `prepaid` - Prepaid card."
63644
+ },
63645
+ "bin": {
63646
+ "type": "string",
63647
+ "minLength": 1,
63648
+ "maxLength": 255,
63649
+ "nullable": true,
63650
+ "description": "Bank identification number recorded for this transaction (first 6-8 digits). Send a value to replace the stored one, omit the property to keep it, or send `null` to clear it. A value consisting only of whitespace or invisible characters is rejected - use `null` to clear."
63651
+ },
63652
+ "fingerprint": {
63653
+ "type": "string",
63654
+ "minLength": 1,
63655
+ "maxLength": 255,
63656
+ "nullable": true,
63657
+ "description": "Unique card fingerprint recorded for this transaction for cross-channel and cross-PSP card identification. Carries the Payment Account Reference (PAR) where the PSP provides it. Send a value to replace the stored one, omit the property to keep it, or send `null` to clear it. A value consisting only of whitespace or invisible characters is rejected - use `null` to clear."
63658
+ },
63659
+ "acquirerName": {
63660
+ "type": "string",
63661
+ "minLength": 1,
63662
+ "maxLength": 255,
63663
+ "nullable": true,
63664
+ "description": "Name of the acquiring bank recorded for this transaction. Send a value to replace the stored one, omit the property to keep it, or send `null` to clear it. A value consisting only of whitespace or invisible characters is rejected - use `null` to clear."
63665
+ },
63666
+ "issuerName": {
63667
+ "type": "string",
63668
+ "minLength": 1,
63669
+ "maxLength": 255,
63670
+ "nullable": true,
63671
+ "description": "Name of the card issuing bank recorded for this transaction. Send a value to replace the stored one, omit the property to keep it, or send `null` to clear it. A value consisting only of whitespace or invisible characters is rejected - use `null` to clear."
63672
+ },
63673
+ "issuerCode": {
63674
+ "type": "string",
63675
+ "minLength": 1,
63676
+ "maxLength": 255,
63677
+ "nullable": true,
63678
+ "description": "Code of the card issuing bank recorded for this transaction. Send a value to replace the stored one, omit the property to keep it, or send `null` to clear it. A value consisting only of whitespace or invisible characters is rejected - use `null` to clear."
63679
+ },
63425
63680
  "methodType": {
63426
63681
  "type": "string",
63427
63682
  "enum": [
@@ -63488,7 +63743,8 @@
63488
63743
  "expYear": {
63489
63744
  "type": "string"
63490
63745
  }
63491
- }
63746
+ },
63747
+ "description": "Card and payment method details recorded for this transaction. Omitting the whole `paymentMethod` object leaves every stored card value unchanged. When the object is present, each of its properties is applied independently: a property that is present is written, and a property that is absent from the object keeps its stored value."
63492
63748
  },
63493
63749
  "status": {
63494
63750
  "type": "string",
@@ -71665,7 +71921,7 @@
71665
71921
  ],
71666
71922
  "info": {
71667
71923
  "title": "Public API",
71668
- "version": "3.245.3",
71924
+ "version": "3.246.0",
71669
71925
  "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"
71670
71926
  },
71671
71927
  "servers": [
@@ -71679,18 +71935,18 @@
71679
71935
  }
71680
71936
  }
71681
71937
  ],
71682
- "buildTimestamp": "2026-09-09T11:19:50.047Z",
71938
+ "buildTimestamp": "2026-09-09T11:53:44.781Z",
71683
71939
  "stats": {
71684
71940
  "totalEndpoints": 640,
71685
- "originalSize": 5796134,
71686
- "optimizedSize": 1619628,
71687
- "reductionPercent": 72.06,
71688
- "buildDuration": 1555,
71941
+ "originalSize": 5825490,
71942
+ "optimizedSize": 1630992,
71943
+ "reductionPercent": 72,
71944
+ "buildDuration": 1752,
71689
71945
  "responseSchemas": {
71690
71946
  "total": 640,
71691
71947
  "withSchemas": 640,
71692
- "totalSchemaSize": 3303477,
71693
- "averageSchemaSize": 5162
71948
+ "totalSchemaSize": 3315541,
71949
+ "averageSchemaSize": 5181
71694
71950
  }
71695
71951
  }
71696
71952
  }