CreatePartyLocationData
Create an independently identified site with exact public geography. Optional relocates creates a new identity and retires the referenced active site atomically; its Party and revision must match.
Properties
| Name | Type | Description |
|---|---|---|
| label | string | Trimmed nonblank single-line label, at most 255 UTF-8 bytes. Never establishes site identity. |
| roles | array | Business use of a site. No assertion about listing stock, dispatch or pickup. |
| geography | object | |
| position | object | |
| evidence | object | |
| relocates | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-create-party-location-data-schema.json",
"title": "CreatePartyLocationData",
"description": "Create an independently identified site with exact public geography. Optional relocates creates a new identity and retires the referenced active site atomically; its Party and revision must match.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/aura-historia-com-party-api-openapi.yml#/components/schemas/CreatePartyLocationData",
"type": "object",
"additionalProperties": false,
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Trimmed nonblank single-line label, at most 255 UTF-8 bytes. Never establishes site identity."
},
"roles": {
"type": "array",
"maxItems": 4,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"BUSINESS_PREMISES",
"WAREHOUSE",
"REGISTERED_ADDRESS",
"CORRESPONDENCE"
]
},
"description": "Business use of a site. No assertion about listing stock, dispatch or pickup.",
"default": []
},
"geography": {
"allOf": [
{
"$ref": "#/$defs/PartyLocationGeography"
}
]
},
"position": {
"allOf": [
{
"$ref": "#/$defs/PartyLocationPosition"
}
]
},
"evidence": {
"allOf": [
{
"$ref": "#/$defs/PartyLocationEvidence"
}
]
},
"relocates": {
"allOf": [
{
"$ref": "#/$defs/ExpectedPartyLocation"
}
]
}
},
"$defs": {
"ExpectedPartyLocation": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"revision"
],
"properties": {
"id": {
"$ref": "#/$defs/PartyLocationId"
},
"revision": {
"type": "integer",
"format": "int64",
"minimum": 1,
"maximum": 9223372036854775807
}
}
},
"PartyLocationEvidence": {
"type": "object",
"additionalProperties": false,
"required": [
"reference",
"scope"
],
"properties": {
"reference": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "Opaque nonblank single-line evidence/source reference; never fetched. At most 2048 UTF-8 bytes."
},
"observedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"scope": {
"type": "string",
"enum": [
"SITE_DESCRIPTION",
"REGISTERED_ADDRESS",
"CORRESPONDENCE_ADDRESS"
],
"description": "Declared assertion scope; never caller identity, authorization or trust."
}
}
},
"PartyLocationGeography": {
"type": "object",
"additionalProperties": false,
"required": [
"referenceRelease"
],
"properties": {
"referenceRelease": {
"type": "string",
"enum": [
"iso-codes-4.20.1"
]
},
"addressText": {
"type": [
"string",
"null"
],
"maxLength": 4096,
"description": "Verbatim free-text assertion; at most 4096 UTF-8 bytes. No geocoding or postal inference."
},
"country": {
"type": [
"string",
"null"
],
"pattern": "^[A-Z]{2}$",
"description": "Exact current ISO alpha-2 country in the named immutable release."
},
"subdivision": {
"type": [
"string",
"null"
],
"description": "Complete ISO 3166-2 code in the named release; must agree with country when supplied."
},
"postalCode": {
"type": [
"string",
"null"
],
"maxLength": 64,
"description": "Single-line verbatim postal assertion, at most 64 UTF-8 bytes."
}
},
"description": "Partial caller assertions. At least one geographic field must be present and nonblank. Coordinates are separate. No synchronous geocoding."
},
"PartyLocationId": {
"type": "string",
"pattern": "^ploc_[0-7][0-9a-hjkmnp-tv-z]{25}$",
"description": "Strict UUIDv7 PartyLocation TypeID; bare UUIDs and foreign prefixes are rejected."
},
"PartyLocationPosition": {
"type": "object",
"additionalProperties": false,
"required": [
"latitudeDegrees",
"longitudeDegrees",
"precision"
],
"properties": {
"latitudeDegrees": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitudeDegrees": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"precision": {
"type": "string",
"enum": [
"PREMISES",
"STREET",
"LOCALITY",
"REPRESENTATIVE"
]
},
"accuracyMetres": {
"type": [
"number",
"null"
],
"minimum": 0
}
},
"description": "Finite caller-asserted WGS84 coordinates with explicit precision. Not geocoder-derived evidence; (0,0) is valid."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/aura-historia-com-create-party-location-data"
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.