{
  "type": "object",
  "title": "Carrier",
  "description": "A Carrier is a transport service provider responsible for moving goods across distances. Carriers operate fleets of vehicles and may own/manage logistics hubs. Maps to beckn:Provider. ",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique carrier identifier",
      "example": "CAR-DTDC-001"
    },
    "name": {
      "type": "string",
      "description": "Legal name of the carrier",
      "example": "DTDC Express Limited"
    },
    "code": {
      "type": "string",
      "description": "Short carrier code",
      "example": "DTDC"
    },
    "logo": {
      "type": "string",
      "format": "uri",
      "description": "URL to carrier logo"
    },
    "website": {
      "type": "string",
      "format": "uri"
    },
    "contact": {
      "$ref": "https://schema.nfh.global/Contact/v2.0/schema.json"
    },
    "rating": {
      "type": "number",
      "minimum": 1,
      "maximum": 5,
      "example": 4.2
    },
    "serviceTypes": {
      "type": "array",
      "description": "Types of logistics services offered",
      "items": {
        "type": "string",
        "enum": [
          "HYPERLOCAL",
          "COURIER",
          "INTERSTATE",
          "LONG_HAUL",
          "EXPRESS"
        ]
      }
    },
    "serviceCoverage": {
      "type": "array",
      "description": "Geographic regions served",
      "items": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string"
          },
          "states": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "pincodes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    "fleetSize": {
      "type": "integer",
      "description": "Number of vehicles in fleet",
      "example": 500
    },
    "hubs": {
      "type": "array",
      "description": "Logistics hubs operated by this carrier",
      "items": {
        "$ref": "https://schema.nfh.global/Hub/v2.0/schema.json"
      }
    },
    "licenseNumber": {
      "type": "string",
      "description": "Transport license number"
    },
    "gstNumber": {
      "type": "string",
      "description": "GST registration number"
    },
    "panNumber": {
      "type": "string",
      "description": "PAN for tax purposes"
    },
    "active": {
      "type": "boolean",
      "description": "Whether carrier is currently active on network",
      "example": true
    }
  },
  "$id": "https://schema.nfh.global/Carrier/v2.0",
  "x-iri": "https://schema.nfh.global/Carrier/v2.0",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}