@ampeco/public-api-mcp 3.240.4 → 3.241.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": 637,
3
- "originalSize": 5664280,
4
- "optimizedSize": 1583489,
5
- "reductionPercent": 72.04,
6
- "buildDuration": 1504,
3
+ "originalSize": 5709854,
4
+ "optimizedSize": 1597678,
5
+ "reductionPercent": 72.02,
6
+ "buildDuration": 1488,
7
7
  "responseSchemas": {
8
8
  "total": 637,
9
9
  "withSchemas": 637,
10
- "totalSchemaSize": 3219701,
11
- "averageSchemaSize": 5054
10
+ "totalSchemaSize": 3244419,
11
+ "averageSchemaSize": 5093
12
12
  }
13
13
  }
@@ -39347,7 +39347,8 @@
39347
39347
  "type": "object",
39348
39348
  "properties": {
39349
39349
  "name": {
39350
- "type": "string"
39350
+ "type": "string",
39351
+ "description": "Company name of the Partner. The value is written to the English (`en`) locale only. To write this field in other locales, use `translatedName` in Partners v2.0."
39351
39352
  },
39352
39353
  "regNo": {
39353
39354
  "type": "string",
@@ -39616,7 +39617,8 @@
39616
39617
  },
39617
39618
  "city": {
39618
39619
  "type": "string",
39619
- "nullable": true
39620
+ "nullable": true,
39621
+ "description": "City of the Partner. The value is written to the English (`en`) locale only. To write this field in other locales, use `translatedCity` in Partners v2.0."
39620
39622
  },
39621
39623
  "postcode": {
39622
39624
  "type": "string",
@@ -39624,7 +39626,8 @@
39624
39626
  },
39625
39627
  "address": {
39626
39628
  "type": "string",
39627
- "nullable": true
39629
+ "nullable": true,
39630
+ "description": "Address of the Partner. The value is written to the English (`en`) locale only. To write this field in other locales, use `translatedAddress` in Partners v2.0."
39628
39631
  },
39629
39632
  "contactPerson": {
39630
39633
  "type": "string",
@@ -39829,7 +39832,8 @@
39829
39832
  "type": "object",
39830
39833
  "properties": {
39831
39834
  "name": {
39832
- "type": "string"
39835
+ "type": "string",
39836
+ "description": "Company name of the Partner. The value is written to the English (`en`) locale only. To write this field in other locales, use `translatedName` in Partners v2.0."
39833
39837
  },
39834
39838
  "regNo": {
39835
39839
  "type": "string",
@@ -40098,7 +40102,8 @@
40098
40102
  },
40099
40103
  "city": {
40100
40104
  "type": "string",
40101
- "nullable": true
40105
+ "nullable": true,
40106
+ "description": "City of the Partner. The value is written to the English (`en`) locale only. To write this field in other locales, use `translatedCity` in Partners v2.0."
40102
40107
  },
40103
40108
  "postcode": {
40104
40109
  "type": "string",
@@ -40106,7 +40111,8 @@
40106
40111
  },
40107
40112
  "address": {
40108
40113
  "type": "string",
40109
- "nullable": true
40114
+ "nullable": true,
40115
+ "description": "Address of the Partner. The value is written to the English (`en`) locale only. To write this field in other locales, use `translatedAddress` in Partners v2.0."
40110
40116
  },
40111
40117
  "contactPerson": {
40112
40118
  "type": "string",
@@ -40644,7 +40650,27 @@
40644
40650
  },
40645
40651
  "name": {
40646
40652
  "type": "string",
40647
- "description": "Company name of the Partner"
40653
+ "description": "**This property is deprecated. Use `translatedName` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedName`. Company name of the Partner"
40654
+ },
40655
+ "translatedName": {
40656
+ "type": "array",
40657
+ "items": {
40658
+ "type": "object",
40659
+ "properties": {
40660
+ "locale": {
40661
+ "type": "string",
40662
+ "description": "valid locale configured for the tenant"
40663
+ },
40664
+ "translation": {
40665
+ "type": "string"
40666
+ }
40667
+ },
40668
+ "required": [
40669
+ "locale",
40670
+ "translation"
40671
+ ]
40672
+ },
40673
+ "description": "Company name of the Partner 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`."
40648
40674
  },
40649
40675
  "regNo": {
40650
40676
  "type": "string",
@@ -40656,7 +40682,28 @@
40656
40682
  },
40657
40683
  "address": {
40658
40684
  "type": "string",
40659
- "nullable": true
40685
+ "nullable": true,
40686
+ "description": "**This property is deprecated. Use `translatedAddress` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedAddress`."
40687
+ },
40688
+ "translatedAddress": {
40689
+ "type": "array",
40690
+ "items": {
40691
+ "type": "object",
40692
+ "properties": {
40693
+ "locale": {
40694
+ "type": "string",
40695
+ "description": "valid locale configured for the tenant"
40696
+ },
40697
+ "translation": {
40698
+ "type": "string"
40699
+ }
40700
+ },
40701
+ "required": [
40702
+ "locale",
40703
+ "translation"
40704
+ ]
40705
+ },
40706
+ "description": "Address of the Partner 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`."
40660
40707
  },
40661
40708
  "postcode": {
40662
40709
  "type": "string",
@@ -40664,7 +40711,28 @@
40664
40711
  },
40665
40712
  "city": {
40666
40713
  "type": "string",
40667
- "nullable": true
40714
+ "nullable": true,
40715
+ "description": "**This property is deprecated. Use `translatedCity` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedCity`."
40716
+ },
40717
+ "translatedCity": {
40718
+ "type": "array",
40719
+ "items": {
40720
+ "type": "object",
40721
+ "properties": {
40722
+ "locale": {
40723
+ "type": "string",
40724
+ "description": "valid locale configured for the tenant"
40725
+ },
40726
+ "translation": {
40727
+ "type": "string"
40728
+ }
40729
+ },
40730
+ "required": [
40731
+ "locale",
40732
+ "translation"
40733
+ ]
40734
+ },
40735
+ "description": "City of the Partner 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`."
40668
40736
  },
40669
40737
  "country": {
40670
40738
  "type": "string",
@@ -40927,6 +40995,26 @@
40927
40995
  "nullable": true,
40928
40996
  "description": "When country is not in US, AU, CA, UM or RO, you can provide the region"
40929
40997
  },
40998
+ "translatedRegion": {
40999
+ "type": "array",
41000
+ "items": {
41001
+ "type": "object",
41002
+ "properties": {
41003
+ "locale": {
41004
+ "type": "string",
41005
+ "description": "valid locale configured for the tenant"
41006
+ },
41007
+ "translation": {
41008
+ "type": "string"
41009
+ }
41010
+ },
41011
+ "required": [
41012
+ "locale",
41013
+ "translation"
41014
+ ]
41015
+ },
41016
+ "description": "Region of the Partner 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 Partner's country supports states (US, AU, CA, UM, RO) — `state` applies instead and is not translatable. Cannot be provided together with the deprecated `region`."
41017
+ },
40930
41018
  "state": {
40931
41019
  "anyOf": [
40932
41020
  {
@@ -41330,6 +41418,81 @@
41330
41418
  "type": "string",
41331
41419
  "nullable": true,
41332
41420
  "description": "BIC/SWIFT code of the bank."
41421
+ },
41422
+ "bankName": {
41423
+ "type": "string",
41424
+ "nullable": true,
41425
+ "description": "**This property is deprecated. Use `translatedBankName` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedBankName`. Ignored when the bank name field is disabled in the operator's bank details settings. Name of the bank."
41426
+ },
41427
+ "bankAddress": {
41428
+ "type": "string",
41429
+ "nullable": true,
41430
+ "description": "**This property is deprecated. Use `translatedBankAddress` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedBankAddress`. Ignored when the bank address field is disabled in the operator's bank details settings. Address of the bank."
41431
+ },
41432
+ "bankAccountHolder": {
41433
+ "type": "string",
41434
+ "nullable": true,
41435
+ "description": "**This property is deprecated. Use `translatedBankAccountHolder` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedBankAccountHolder`. Ignored when the bank account holder field is disabled in the operator's bank details settings. Name of the bank account holder."
41436
+ },
41437
+ "translatedBankName": {
41438
+ "type": "array",
41439
+ "items": {
41440
+ "type": "object",
41441
+ "properties": {
41442
+ "locale": {
41443
+ "type": "string",
41444
+ "description": "valid locale configured for the tenant"
41445
+ },
41446
+ "translation": {
41447
+ "type": "string"
41448
+ }
41449
+ },
41450
+ "required": [
41451
+ "locale",
41452
+ "translation"
41453
+ ]
41454
+ },
41455
+ "description": "Name of the bank per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the bank name: 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 `bankName`. Ignored when the bank name field is disabled in the operator's bank details settings."
41456
+ },
41457
+ "translatedBankAddress": {
41458
+ "type": "array",
41459
+ "items": {
41460
+ "type": "object",
41461
+ "properties": {
41462
+ "locale": {
41463
+ "type": "string",
41464
+ "description": "valid locale configured for the tenant"
41465
+ },
41466
+ "translation": {
41467
+ "type": "string"
41468
+ }
41469
+ },
41470
+ "required": [
41471
+ "locale",
41472
+ "translation"
41473
+ ]
41474
+ },
41475
+ "description": "Address of the bank per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the bank 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 `bankAddress`. Ignored when the bank address field is disabled in the operator's bank details settings."
41476
+ },
41477
+ "translatedBankAccountHolder": {
41478
+ "type": "array",
41479
+ "items": {
41480
+ "type": "object",
41481
+ "properties": {
41482
+ "locale": {
41483
+ "type": "string",
41484
+ "description": "valid locale configured for the tenant"
41485
+ },
41486
+ "translation": {
41487
+ "type": "string"
41488
+ }
41489
+ },
41490
+ "required": [
41491
+ "locale",
41492
+ "translation"
41493
+ ]
41494
+ },
41495
+ "description": "Name of the bank account holder per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the bank account holder: 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 `bankAccountHolder`. Ignored when the bank account holder field is disabled in the operator's bank details settings."
41333
41496
  }
41334
41497
  }
41335
41498
  },
@@ -41345,9 +41508,7 @@
41345
41508
  "description": "The operator ID for this resource. Required for global admin tokens. Optional for operator-scoped tokens (defaults to token's operator)."
41346
41509
  }
41347
41510
  },
41348
- "required": [
41349
- "name"
41350
- ]
41511
+ "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."
41351
41512
  }
41352
41513
  }
41353
41514
  }
@@ -41412,6 +41573,9 @@
41412
41573
  },
41413
41574
  "404": {
41414
41575
  "description": "The record is not found"
41576
+ },
41577
+ "429": {
41578
+ "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
41415
41579
  }
41416
41580
  }
41417
41581
  },
@@ -41514,7 +41678,27 @@
41514
41678
  },
41515
41679
  "name": {
41516
41680
  "type": "string",
41517
- "description": "Company name of the Partner"
41681
+ "description": "**This property is deprecated. Use `translatedName` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedName`. Company name of the Partner"
41682
+ },
41683
+ "translatedName": {
41684
+ "type": "array",
41685
+ "items": {
41686
+ "type": "object",
41687
+ "properties": {
41688
+ "locale": {
41689
+ "type": "string",
41690
+ "description": "valid locale configured for the tenant"
41691
+ },
41692
+ "translation": {
41693
+ "type": "string"
41694
+ }
41695
+ },
41696
+ "required": [
41697
+ "locale",
41698
+ "translation"
41699
+ ]
41700
+ },
41701
+ "description": "Company name of the Partner 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`."
41518
41702
  },
41519
41703
  "regNo": {
41520
41704
  "type": "string",
@@ -41526,7 +41710,28 @@
41526
41710
  },
41527
41711
  "address": {
41528
41712
  "type": "string",
41529
- "nullable": true
41713
+ "nullable": true,
41714
+ "description": "**This property is deprecated. Use `translatedAddress` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedAddress`."
41715
+ },
41716
+ "translatedAddress": {
41717
+ "type": "array",
41718
+ "items": {
41719
+ "type": "object",
41720
+ "properties": {
41721
+ "locale": {
41722
+ "type": "string",
41723
+ "description": "valid locale configured for the tenant"
41724
+ },
41725
+ "translation": {
41726
+ "type": "string"
41727
+ }
41728
+ },
41729
+ "required": [
41730
+ "locale",
41731
+ "translation"
41732
+ ]
41733
+ },
41734
+ "description": "Address of the Partner 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`."
41530
41735
  },
41531
41736
  "postcode": {
41532
41737
  "type": "string",
@@ -41534,7 +41739,28 @@
41534
41739
  },
41535
41740
  "city": {
41536
41741
  "type": "string",
41537
- "nullable": true
41742
+ "nullable": true,
41743
+ "description": "**This property is deprecated. Use `translatedCity` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedCity`."
41744
+ },
41745
+ "translatedCity": {
41746
+ "type": "array",
41747
+ "items": {
41748
+ "type": "object",
41749
+ "properties": {
41750
+ "locale": {
41751
+ "type": "string",
41752
+ "description": "valid locale configured for the tenant"
41753
+ },
41754
+ "translation": {
41755
+ "type": "string"
41756
+ }
41757
+ },
41758
+ "required": [
41759
+ "locale",
41760
+ "translation"
41761
+ ]
41762
+ },
41763
+ "description": "City of the Partner 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`."
41538
41764
  },
41539
41765
  "country": {
41540
41766
  "type": "string",
@@ -41797,6 +42023,26 @@
41797
42023
  "nullable": true,
41798
42024
  "description": "When country is not in US, AU, CA, UM or RO, you can provide the region"
41799
42025
  },
42026
+ "translatedRegion": {
42027
+ "type": "array",
42028
+ "items": {
42029
+ "type": "object",
42030
+ "properties": {
42031
+ "locale": {
42032
+ "type": "string",
42033
+ "description": "valid locale configured for the tenant"
42034
+ },
42035
+ "translation": {
42036
+ "type": "string"
42037
+ }
42038
+ },
42039
+ "required": [
42040
+ "locale",
42041
+ "translation"
42042
+ ]
42043
+ },
42044
+ "description": "Region of the Partner 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 Partner's country supports states (US, AU, CA, UM, RO) — `state` applies instead and is not translatable. Cannot be provided together with the deprecated `region`."
42045
+ },
41800
42046
  "state": {
41801
42047
  "anyOf": [
41802
42048
  {
@@ -42200,6 +42446,81 @@
42200
42446
  "type": "string",
42201
42447
  "nullable": true,
42202
42448
  "description": "BIC/SWIFT code of the bank."
42449
+ },
42450
+ "bankName": {
42451
+ "type": "string",
42452
+ "nullable": true,
42453
+ "description": "**This property is deprecated. Use `translatedBankName` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedBankName`. Ignored when the bank name field is disabled in the operator's bank details settings. Name of the bank."
42454
+ },
42455
+ "bankAddress": {
42456
+ "type": "string",
42457
+ "nullable": true,
42458
+ "description": "**This property is deprecated. Use `translatedBankAddress` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedBankAddress`. Ignored when the bank address field is disabled in the operator's bank details settings. Address of the bank."
42459
+ },
42460
+ "bankAccountHolder": {
42461
+ "type": "string",
42462
+ "nullable": true,
42463
+ "description": "**This property is deprecated. Use `translatedBankAccountHolder` instead.** The value is written to the English (`en`) locale only. Cannot be provided together with `translatedBankAccountHolder`. Ignored when the bank account holder field is disabled in the operator's bank details settings. Name of the bank account holder."
42464
+ },
42465
+ "translatedBankName": {
42466
+ "type": "array",
42467
+ "items": {
42468
+ "type": "object",
42469
+ "properties": {
42470
+ "locale": {
42471
+ "type": "string",
42472
+ "description": "valid locale configured for the tenant"
42473
+ },
42474
+ "translation": {
42475
+ "type": "string"
42476
+ }
42477
+ },
42478
+ "required": [
42479
+ "locale",
42480
+ "translation"
42481
+ ]
42482
+ },
42483
+ "description": "Name of the bank per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the bank name: 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 `bankName`. Ignored when the bank name field is disabled in the operator's bank details settings."
42484
+ },
42485
+ "translatedBankAddress": {
42486
+ "type": "array",
42487
+ "items": {
42488
+ "type": "object",
42489
+ "properties": {
42490
+ "locale": {
42491
+ "type": "string",
42492
+ "description": "valid locale configured for the tenant"
42493
+ },
42494
+ "translation": {
42495
+ "type": "string"
42496
+ }
42497
+ },
42498
+ "required": [
42499
+ "locale",
42500
+ "translation"
42501
+ ]
42502
+ },
42503
+ "description": "Address of the bank per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the bank 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 `bankAddress`. Ignored when the bank address field is disabled in the operator's bank details settings."
42504
+ },
42505
+ "translatedBankAccountHolder": {
42506
+ "type": "array",
42507
+ "items": {
42508
+ "type": "object",
42509
+ "properties": {
42510
+ "locale": {
42511
+ "type": "string",
42512
+ "description": "valid locale configured for the tenant"
42513
+ },
42514
+ "translation": {
42515
+ "type": "string"
42516
+ }
42517
+ },
42518
+ "required": [
42519
+ "locale",
42520
+ "translation"
42521
+ ]
42522
+ },
42523
+ "description": "Name of the bank account holder per locale. Only locales configured for the tenant are accepted. Submitting this field replaces the whole locale set for the bank account holder: 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 `bankAccountHolder`. Ignored when the bank account holder field is disabled in the operator's bank details settings."
42203
42524
  }
42204
42525
  }
42205
42526
  },
@@ -71016,7 +71337,7 @@
71016
71337
  ],
71017
71338
  "info": {
71018
71339
  "title": "Public API",
71019
- "version": "3.240.4",
71340
+ "version": "3.241.0",
71020
71341
  "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"
71021
71342
  },
71022
71343
  "servers": [
@@ -71030,18 +71351,18 @@
71030
71351
  }
71031
71352
  }
71032
71353
  ],
71033
- "buildTimestamp": "2026-08-31T07:57:49.811Z",
71354
+ "buildTimestamp": "2026-08-31T11:19:48.055Z",
71034
71355
  "stats": {
71035
71356
  "totalEndpoints": 637,
71036
- "originalSize": 5664280,
71037
- "optimizedSize": 1583489,
71038
- "reductionPercent": 72.04,
71039
- "buildDuration": 1504,
71357
+ "originalSize": 5709854,
71358
+ "optimizedSize": 1597678,
71359
+ "reductionPercent": 72.02,
71360
+ "buildDuration": 1488,
71040
71361
  "responseSchemas": {
71041
71362
  "total": 637,
71042
71363
  "withSchemas": 637,
71043
- "totalSchemaSize": 3219701,
71044
- "averageSchemaSize": 5054
71364
+ "totalSchemaSize": 3244419,
71365
+ "averageSchemaSize": 5093
71045
71366
  }
71046
71367
  }
71047
71368
  }