{
  "info": {
    "name": "VIN Foundry API",
    "description": "Free, keyless VIN generation and decoding. Generated VINs are synthetic: each uses a real manufacturer prefix with a randomised serial, so it is structurally valid and decodes correctly, and none is taken from a real-vehicle record. A random serial can still coincide with a real VIN by chance, so never present a generated VIN as a real vehicle identifier.",
    "version": "1.0",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://vinfoundry.com"
    }
  ],
  "item": [
    {
      "name": "Liveness check",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/health",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "health"
          ],
          "query": []
        },
        "description": "Liveness check"
      }
    },
    {
      "name": "Generate synthetic VINs",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/vin/generate",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "vin",
            "generate"
          ],
          "query": [
            {
              "key": "count",
              "value": "",
              "description": "",
              "disabled": true
            },
            {
              "key": "majorOnly",
              "value": "",
              "description": "Draw only from the curated major makes. Ignored when an explicit `make` is supplied.",
              "disabled": true
            },
            {
              "key": "make",
              "value": "",
              "description": "One make, or several. Repeat the parameter to name more than one — `?make=Ford&make=Toyota` returns either. Makes combine as OR with each other and as AND with every other filter. Makes come from NHTSA’s VPIC database, which covers US-market vehicles only.",
              "disabled": true
            },
            {
              "key": "model",
              "value": "",
              "description": "",
              "disabled": true
            },
            {
              "key": "year",
              "value": "",
              "description": "",
              "disabled": true
            },
            {
              "key": "bodyStyle",
              "value": "",
              "description": "",
              "disabled": true
            },
            {
              "key": "fuelType",
              "value": "",
              "description": "",
              "disabled": true
            },
            {
              "key": "seed",
              "value": "",
              "description": "Any string or integer. The same seed returns the same batch.",
              "disabled": true
            }
          ]
        },
        "description": "Every VIN is structurally valid and decodes correctly, and its randomised serial is not taken from any real-vehicle record. A random serial can still coincide with a real VIN by chance, so never present a generated VIN as a real vehicle identifier."
      }
    },
    {
      "name": "Check a VIN’s structure and check digit",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/vin/validate/:vin",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "vin",
            "validate",
            ":vin"
          ],
          "query": [],
          "variable": [
            {
              "key": "vin",
              "value": "",
              "description": ""
            }
          ]
        },
        "description": "Pure arithmetic — this endpoint does not consult the VPIC database."
      }
    },
    {
      "name": "Decode a single VIN, with NCIC codes",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/vin/decode/:vin",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "vin",
            "decode",
            ":vin"
          ],
          "query": [],
          "variable": [
            {
              "key": "vin",
              "value": "",
              "description": ""
            }
          ]
        },
        "description": "Decode a single VIN, with NCIC codes"
      }
    },
    {
      "name": "Decode up to 100 VINs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v1/vin/decode",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "vin",
            "decode"
          ],
          "query": []
        },
        "description": "Decode up to 100 VINs",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"vins\": [\"5UXFA13564LU32275\"]\n}"
        }
      }
    },
    {
      "name": "Makes available to generate, with a count each",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/reference/makes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "reference",
            "makes"
          ],
          "query": [
            {
              "key": "limit",
              "value": "",
              "description": "How many items to return. Omit for the whole list. When either `limit` or `offset` is given, `meta.total` reports the number of items before the page was taken.",
              "disabled": true
            },
            {
              "key": "offset",
              "value": "",
              "description": "How many items to skip before the page. Omit for the whole list.",
              "disabled": true
            },
            {
              "key": "majorOnly",
              "value": "",
              "description": "Return only the curated major makes rather than all of them. Counts and `meta.skeletonCount` are unchanged.",
              "disabled": true
            }
          ]
        },
        "description": "Counts let a caller avoid offering a filter that would match nothing. For a sparse field the counts sum to less than the dataset size."
      }
    },
    {
      "name": "Models available for a make",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/reference/models",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "reference",
            "models"
          ],
          "query": [
            {
              "key": "limit",
              "value": "",
              "description": "How many items to return. Omit for the whole list. When either `limit` or `offset` is given, `meta.total` reports the number of items before the page was taken.",
              "disabled": true
            },
            {
              "key": "offset",
              "value": "",
              "description": "How many items to skip before the page. Omit for the whole list.",
              "disabled": true
            },
            {
              "key": "make",
              "value": "",
              "description": "The make to list models for.",
              "disabled": true
            }
          ]
        },
        "description": "Models available for a make"
      }
    },
    {
      "name": "Model years available, ascending",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/reference/years",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "reference",
            "years"
          ],
          "query": []
        },
        "description": "Model years available, ascending"
      }
    },
    {
      "name": "Body styles available, with counts",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/reference/body-styles",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "reference",
            "body-styles"
          ],
          "query": []
        },
        "description": "Body styles available, with counts"
      }
    },
    {
      "name": "Fuel types available, with counts",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/reference/fuel-types",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "reference",
            "fuel-types"
          ],
          "query": []
        },
        "description": "Fuel types available, with counts"
      }
    },
    {
      "name": "World Manufacturer Identifier summary",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/reference/wmi/:wmi",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "reference",
            "wmi",
            ":wmi"
          ],
          "query": [],
          "variable": [
            {
              "key": "wmi",
              "value": "",
              "description": ""
            }
          ]
        },
        "description": "World Manufacturer Identifier summary"
      }
    },
    {
      "name": "NCIC vehicle make codes (NIEM 6.0)",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/ncic/makes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "ncic",
            "makes"
          ],
          "query": [
            {
              "key": "limit",
              "value": "",
              "description": "How many items to return. Omit for the whole list. When either `limit` or `offset` is given, `meta.total` reports the number of items before the page was taken.",
              "disabled": true
            },
            {
              "key": "offset",
              "value": "",
              "description": "How many items to skip before the page. Omit for the whole list.",
              "disabled": true
            },
            {
              "key": "q",
              "value": "",
              "description": "Case-insensitive substring of the code or the name.",
              "disabled": true
            }
          ]
        },
        "description": "NCIC vehicle make codes (NIEM 6.0)"
      }
    },
    {
      "name": "NCIC vehicle colour codes",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/ncic/colors",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "ncic",
            "colors"
          ],
          "query": [
            {
              "key": "limit",
              "value": "",
              "description": "How many items to return. Omit for the whole list. When either `limit` or `offset` is given, `meta.total` reports the number of items before the page was taken.",
              "disabled": true
            },
            {
              "key": "offset",
              "value": "",
              "description": "How many items to skip before the page. Omit for the whole list.",
              "disabled": true
            },
            {
              "key": "q",
              "value": "",
              "description": "Case-insensitive substring of the code or the name.",
              "disabled": true
            }
          ]
        },
        "description": "NCIC vehicle colour codes"
      }
    },
    {
      "name": "NCIC vehicle style codes",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/ncic/styles",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "ncic",
            "styles"
          ],
          "query": [
            {
              "key": "limit",
              "value": "",
              "description": "How many items to return. Omit for the whole list. When either `limit` or `offset` is given, `meta.total` reports the number of items before the page was taken.",
              "disabled": true
            },
            {
              "key": "offset",
              "value": "",
              "description": "How many items to skip before the page. Omit for the whole list.",
              "disabled": true
            },
            {
              "key": "q",
              "value": "",
              "description": "Case-insensitive substring of the code or the name.",
              "disabled": true
            }
          ]
        },
        "description": "Codes retired by the NCIC 2000 Code Manual in 2002 are flagged `retired: true`. They remain in the NIEM dataset for reference but must not be written to a title or registration."
      }
    },
    {
      "name": "Resolve a make in either direction",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/v1/ncic/make/:nameOrCode",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "ncic",
            "make",
            ":nameOrCode"
          ],
          "query": [],
          "variable": [
            {
              "key": "nameOrCode",
              "value": "",
              "description": ""
            }
          ]
        },
        "description": "Resolve a make in either direction"
      }
    }
  ]
}