applicationvndcompanyv2json

application/vnd.company.v2+json is a vendor-specific Internet media type used to indicate that a JSON payload conforms to the Company data contract version 2. It follows the conventional vendor tree defined by the IANA registry, using the pattern application/vnd.<vendor>.<version>+json. This designation helps clients and servers negotiate a precise data format beyond generic JSON.

In practice, this type is declared in HTTP headers as the Content-Type of request bodies and the Accept value of responses. When both client and server support the type, they agree on the exact schema and semantics of the payload, enabling versioned contracts and backward compatibility.

The exact JSON structure is defined by Company; the payload is a JSON object that typically includes a version field, a resource or type field, and a data object. Implementations should validate incoming and outgoing documents against the published schema to ensure compatibility and to provide meaningful error reporting when the contract is violated.

IANA registrations or vendor registries may list application/vnd.company.v2+json if Company submits a formal registration. If a type is not registered, it may be treated as private-use or non-standard, reducing interoperability until stakeholders align on a shared contract.

Example: Content-Type: application/vnd.company.v2+json; Accept: application/vnd.company.v2+json. Body: { "version": 2, "resource": "order", "data": { "orderId": "A123", "amount": 19.99 } }