{
  "info": {
    "name": "Swiftend — NINAuth Enterprise",
    "description": "Register an enterprise and get its NINAuth Enterprise ID.\n\nAuth: send your Swiftend `serviceid` header on every request.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "base_url", "value": "https://swiftend.com", "description": "Swiftend API base URL." },
    { "key": "serviceid", "value": "", "description": "Your Swiftend serviceID / auth_key." }
  ],
  "item": [
    {
      "name": "Get Industry & Company Types",
      "request": {
        "method": "GET",
        "header": [
          { "key": "serviceid", "value": "{{serviceid}}", "type": "text" }
        ],
        "url": {
          "raw": "{{base_url}}/ninauth/enterprise/registration-data/",
          "host": ["{{base_url}}"],
          "path": ["ninauth", "enterprise", "registration-data", ""]
        },
        "description": "Valid `industry` and `company_type` values. Use the `text` values exactly as returned."
      },
      "response": [
        {
          "name": "200 OK",
          "originalRequest": {
            "method": "GET",
            "header": [{ "key": "serviceid", "value": "{{serviceid}}" }],
            "url": {
              "raw": "{{base_url}}/ninauth/enterprise/registration-data/",
              "host": ["{{base_url}}"],
              "path": ["ninauth", "enterprise", "registration-data", ""]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "{\n  \"status\": 200,\n  \"success\": true,\n  \"message\": \"successfully retrieved registration data\",\n  \"data\": {\n    \"company_types\": [\n      { \"id\": 1, \"text\": \"Public Sector\" },\n      { \"id\": 2, \"text\": \"Private Sector\" }\n    ],\n    \"industries\": [\n      { \"id\": 2, \"text\": \"Healthcare\" },\n      { \"id\": 3, \"text\": \"Finance\" },\n      { \"id\": 4, \"text\": \"Information Technology\" },\n      { \"id\": 5, \"text\": \"Manufacturing\" },\n      { \"id\": 6, \"text\": \"Education\" },\n      { \"id\": 7, \"text\": \"Energy\" },\n      { \"id\": 8, \"text\": \"Agriculture\" },\n      { \"id\": 9, \"text\": \"Retail\" },\n      { \"id\": 10, \"text\": \"Construction\" },\n      { \"id\": 11, \"text\": \"Transportation\" },\n      { \"id\": 12, \"text\": \"Telecommunications\" }\n    ]\n  }\n}"
        }
      ]
    },
    {
      "name": "Get NINAuth Enterprise ID",
      "request": {
        "method": "POST",
        "header": [
          { "key": "serviceid", "value": "{{serviceid}}", "type": "text" }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "data",
              "value": "{\n  \"name\": \"Harmony Logistics Limited\",\n  \"email\": \"contact@harmony-logistics.example\",\n  \"phone_number\": \"08000000000\",\n  \"address\": \"12 Marina Road, Lagos, Nigeria\",\n  \"website\": \"https://harmony-logistics.example\",\n  \"industry\": \"Transportation\",\n  \"company_type\": \"Private Sector\",\n  \"directors\": [\n    { \"first_name\": \"Ada\", \"last_name\": \"Okafor\", \"email\": \"ada.okafor@harmony-logistics.example\", \"phone_number\": \"08000000001\", \"nin\": \"11111111111\" },\n    { \"first_name\": \"Emeka\", \"last_name\": \"Obi\", \"email\": \"emeka.obi@harmony-logistics.example\", \"phone_number\": \"08000000002\", \"nin\": \"22222222222\" }\n  ]\n}",
              "type": "text",
              "description": "Required. JSON string. Exactly 2 directors. For Finance, also add regulatory_licence_type (CBN|SEC|NAICOM|PARTNER_BANK|OTHER) and regulatory_licence_number."
            },
            { "key": "logo", "type": "file", "src": [], "description": "Required. png/jpg/jpeg, max 5 MB." },
            { "key": "cac_memart", "type": "file", "src": [], "description": "Required. pdf/png/jpg/jpeg, max 5 MB." },
            { "key": "cac_certificate", "type": "file", "src": [], "description": "Required. pdf/png/jpg/jpeg, max 5 MB." },
            { "key": "ndpa_certificate", "type": "file", "src": [], "description": "Required. pdf/png/jpg/jpeg, max 5 MB." },
            { "key": "data_protection_policy", "type": "file", "src": [], "description": "Required. pdf/png/jpg/jpeg, max 5 MB." },
            { "key": "regulatory_licence", "type": "file", "src": [], "description": "Required for Finance only. pdf/png/jpg/jpeg, max 5 MB. Remove otherwise." }
          ]
        },
        "url": {
          "raw": "{{base_url}}/ninauth/enterprise/register/",
          "host": ["{{base_url}}"],
          "path": ["ninauth", "enterprise", "register", ""]
        },
        "description": "Returns the Enterprise ID (`client_id`, e.g. `ENT…`), status `awaiting_approval`. Multipart: `data` JSON + document files. Exactly 2 directors; 5 documents required."
      },
      "response": [
        {
          "name": "200 — Enterprise ID returned",
          "originalRequest": {
            "method": "POST",
            "header": [{ "key": "serviceid", "value": "{{serviceid}}" }],
            "url": {
              "raw": "{{base_url}}/ninauth/enterprise/register/",
              "host": ["{{base_url}}"],
              "path": ["ninauth", "enterprise", "register", ""]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "{\n  \"status\": 200,\n  \"success\": true,\n  \"message\": \"success\",\n  \"data\": {\n    \"id\": \"9f495c30-3778-4a45-a430-1416f02050eb\",\n    \"name\": \"Harmony Logistics Limited\",\n    \"email\": \"contact@harmony-logistics.example\",\n    \"client_id\": \"ENT87D5E1DD26B2\",\n    \"status\": \"awaiting_approval\",\n    \"created_at\": \"2026-10-02T08:15:02.000000Z\"\n  }\n}"
        },
        {
          "name": "400 — validation failed",
          "originalRequest": {
            "method": "POST",
            "header": [{ "key": "serviceid", "value": "{{serviceid}}" }],
            "url": {
              "raw": "{{base_url}}/ninauth/enterprise/register/",
              "host": ["{{base_url}}"],
              "path": ["ninauth", "enterprise", "register", ""]
            }
          },
          "status": "Bad Request",
          "code": 400,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "{\n  \"status\": 400,\n  \"success\": false,\n  \"message\": \"Validation failed. Logo is required, Data Protection Policy is required, Cac Memart is required, Cac Certificate is required, Ndpa Certificate is required\",\n  \"data\": { \"error\": \"Validation failed. ...\" }\n}"
        },
        {
          "name": "401 — invalid credentials",
          "originalRequest": {
            "method": "POST",
            "header": [{ "key": "serviceid", "value": "WRONG" }],
            "url": {
              "raw": "{{base_url}}/ninauth/enterprise/register/",
              "host": ["{{base_url}}"],
              "path": ["ninauth", "enterprise", "register", ""]
            }
          },
          "status": "Unauthorized",
          "code": 401,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "{\n  \"status\": 401,\n  \"success\": false,\n  \"message\": \"Invalid swiftend credentials\",\n  \"data\": { \"error\": \"Invalid swiftend credentials\" }\n}"
        }
      ]
    }
  ]
}