{
  "info": {
    "name": "Saravar — Company API",
    "description": "Saravar company commercial API · مجموعه endpoint های شرکت. Set the `api_key` collection variable before sending. `base_url` is preconfigured. حداقل کارمزد به ازای هر فراخوانی موفق اعمال می‌شود. خطاها هرگز هزینه‌بر نیستند.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "saravar-company-collection"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      { "key": "key", "value": "X-API-KEY", "type": "string" },
      { "key": "value", "value": "{{api_key}}", "type": "string" },
      { "key": "in", "value": "header", "type": "string" }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://www.saravar.com/api",
      "description": "Saravar base URL (production)."
    },
    { "key": "api_key", "value": "", "description": "Your X-API-KEY value." },
    {
      "key": "national_id",
      "value": "12345678901",
      "description": "Sample 11-digit company national ID."
    }
  ],
  "item": [
    {
      "name": "Identity",
      "item": [
        {
          "name": "GET commercial/companies/{national_id}/active-status/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/active-status/?idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "active-status", ""],
              "query": [{ "key": "idempotency_key", "value": "{{$guid}}" }]
            },
            "description": "بررسی وجود و فعال بودن شرکت. هزینه: ۱ واحد."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22001,\"total_charged\":50000,\"data\":{\"national_id\":\"12345678901\",\"is_active\":true,\"dissolution_date\":null,\"has_synced\":true}}"
            }
          ]
        },
        {
          "name": "GET commercial/companies/search/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/search/?company_name=نمونه&limit=10&idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "search", ""],
              "query": [
                {
                  "key": "company_name",
                  "value": "نمونه",
                  "description": "case-insensitive contains. حداقل یکی از این، national_id یا registration_number."
                },
                {
                  "key": "national_id",
                  "value": "",
                  "description": "exact match.",
                  "disabled": true
                },
                {
                  "key": "registration_number",
                  "value": "",
                  "description": "exact match.",
                  "disabled": true
                },
                { "key": "limit", "value": "10", "description": "1–100, default 20." },
                { "key": "idempotency_key", "value": "{{$guid}}" }
              ]
            },
            "description": "جستجوی شرکت. هزینه: هر نتیجه بازگشتی = ۱ واحد."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22002,\"total_charged\":50000,\"data\":[{\"id_code\":\"C0000001\",\"company_name\":\"شرکت نمونه\",\"national_id\":\"12345678901\",\"registration_number\":\"999888\",\"company_type\":\"مسئولیت محدود\",\"registration_date\":\"2019-04-22T00:00:00Z\"}]}"
            }
          ]
        },
        {
          "name": "GET commercial/companies/{national_id}/address/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/address/?idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "address", ""],
              "query": [{ "key": "idempotency_key", "value": "{{$guid}}" }]
            },
            "description": "نشانی ثبت‌شده فعلی. هزینه: ۱ واحد در صورت بازگشت نشانی، صفر در صورت نبود."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22003,\"total_charged\":50000,\"data\":{\"address_text\":\"تهران، خیابان ولیعصر، پلاک ۱۲\",\"postal_code\":\"1411713114\",\"province\":\"تهران\",\"city\":\"تهران\",\"latitude\":\"35.715298\",\"longitude\":\"51.404343\"}}"
            }
          ]
        },
        {
          "name": "GET commercial/companies/{national_id}/categories/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/categories/?idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "categories", ""],
              "query": [{ "key": "idempotency_key", "value": "{{$guid}}" }]
            },
            "description": "طبقه‌بندی صنعتی شرکت. هزینه: هر رکورد = ۱ واحد."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22004,\"total_charged\":50000,\"data\":[{\"id\":7,\"code\":\"62\",\"name_en\":\"Computer programming, consultancy\",\"name_fa\":\"برنامه‌نویسی و مشاوره کامپیوتر\",\"parent_code\":\"J\"}]}"
            }
          ]
        }
      ]
    },
    {
      "name": "People",
      "item": [
        {
          "name": "GET commercial/companies/{national_id}/signatories/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/signatories/?idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "signatories", ""],
              "query": [{ "key": "idempotency_key", "value": "{{$guid}}" }]
            },
            "description": "صاحبان امضای فعال. هزینه: هر رکورد = ۱ واحد. اشخاص دارای حریم‌خصوصی فعال حذف می‌شوند و هزینه‌بر نیستند."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22005,\"total_charged\":50000,\"data\":[{\"person\":{\"id_code\":\"P0000001\",\"full_name\":\"علی رضایی\",\"national_id\":\"1234567890\",\"masked_national_id\":\"123****890\"},\"role_name\":\"مدیرعامل\",\"role_type\":\"ceo\",\"date_assigned\":\"1402-03-15\",\"expire_date\":null}]}"
            }
          ]
        },
        {
          "name": "GET commercial/companies/{national_id}/board-members/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/board-members/?idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "board-members", ""],
              "query": [{ "key": "idempotency_key", "value": "{{$guid}}" }]
            },
            "description": "تمام نقش‌های فعال شرکت. هزینه: هر رکورد = ۱ واحد."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22006,\"total_charged\":50000,\"data\":[{\"person\":{\"id_code\":\"P0000001\",\"full_name\":\"علی رضایی\",\"masked_national_id\":\"123****890\"},\"role_name\":\"عضو هیئت مدیره\",\"role_type\":\"board_member\",\"date_assigned\":\"1402-03-15\",\"expire_date\":null}]}"
            }
          ]
        },
        {
          "name": "POST commercial/companies/role-check/",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"company_national_id\": \"{{national_id}}\",\n  \"person_national_id\": \"1234567890\",\n  \"role_type\": \"ceo\",\n  \"idempotency_key\": \"{{$guid}}\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "url": {
              "raw": "{{base_url}}/commercial/companies/role-check/",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "role-check", ""]
            },
            "description": "اعتبارسنجی نقش شخص در شرکت. هزینه: ۱ واحد."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22007,\"total_charged\":50000,\"data\":{\"is_valid\":true,\"role_type\":\"ceo\",\"role_name\":\"مدیرعامل\",\"date_assigned\":\"1402-03-15\",\"expire_date\":null}}"
            }
          ]
        },
        {
          "name": "GET commercial/companies/{national_id}/capital-shares/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/capital-shares/?idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "capital-shares", ""],
              "query": [{ "key": "idempotency_key", "value": "{{$guid}}" }]
            },
            "description": "سهام‌داران فعلی. هزینه: هر رکورد = ۱ واحد."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22008,\"total_charged\":50000,\"data\":[{\"id\":42,\"total_value\":\"10000000000\",\"number_of_shares\":100000,\"percentage\":\"60.00\",\"is_current\":true,\"person\":{\"id_code\":\"P0000001\",\"full_name\":\"علی رضایی\",\"masked_national_id\":\"123****890\"}}]}"
            }
          ]
        }
      ]
    },
    {
      "name": "Compliance",
      "item": [
        {
          "name": "GET commercial/companies/{national_id}/enamads/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/enamads/?idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "enamads", ""],
              "query": [{ "key": "idempotency_key", "value": "{{$guid}}" }]
            },
            "description": "اینمادهای فعال. هزینه: هر رکورد = ۱ واحد."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22009,\"total_charged\":50000,\"data\":[{\"enamad_id\":\"12345\",\"domain\":\"example.ir\",\"business_title\":\"فروشگاه اینترنتی نمونه\",\"star_count\":2,\"grant_date\":\"1402-01-10\",\"expiry_date\":\"1406-01-09\",\"status_slug\":\"active\"}]}"
            }
          ]
        },
        {
          "name": "GET commercial/companies/{national_id}/licenses/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/licenses/?idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "licenses", ""],
              "query": [{ "key": "idempotency_key", "value": "{{$guid}}" }]
            },
            "description": "پروانه‌ها و مجوزهای فعال. هزینه: هر رکورد = ۱ واحد."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22010,\"total_charged\":50000,\"data\":[{\"type\":\"mojavez.ir\",\"request_number\":\"9876543\",\"license_title\":\"پروانه کسب\",\"organization_title\":\"اتحادیه صنف\",\"issued_at\":\"1402-05-01\",\"expires_at\":\"1407-05-01\",\"status_slug\":\"active\"}]}"
            }
          ]
        }
      ]
    },
    {
      "name": "Assets",
      "item": [
        {
          "name": "GET commercial/companies/{national_id}/trademarks/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/trademarks/?idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "trademarks", ""],
              "query": [{ "key": "idempotency_key", "value": "{{$guid}}" }]
            },
            "description": "نشان‌های تجاری معتبر. هزینه: هر رکورد = ۱ واحد."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22011,\"total_charged\":50000,\"data\":[{\"register_number\":\"987654\",\"claim_number\":\"12345\",\"register_date\":\"2020-06-12T00:00:00Z\",\"valid_from\":\"2020-06-12T00:00:00Z\",\"valid_until\":\"2030-06-11T00:00:00Z\",\"trademark_description\":\"...\"}]}"
            }
          ]
        }
      ]
    },
    {
      "name": "Gazette",
      "item": [
        {
          "name": "GET commercial/companies/{national_id}/legal-notes/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/legal-notes/?limit=10&idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "legal-notes", ""],
              "query": [
                { "key": "limit", "value": "10", "description": "1–100, default 20." },
                { "key": "idempotency_key", "value": "{{$guid}}" }
              ]
            },
            "description": "اطلاعیه‌های روزنامه رسمی. هزینه: هر رکورد = ۱ واحد."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22012,\"total_charged\":50000,\"data\":[{\"id_code\":\"N0000001\",\"title\":\"اعلامیه تغییرات شرکت\",\"letter_date\":\"1403-02-10\",\"newspaper_date\":\"1403-02-15\",\"note_type\":\"change_board_members\",\"title_summary\":\"تغییر اعضای هیات‌مدیره\"}]}"
            }
          ]
        }
      ]
    },
    {
      "name": "Bundle",
      "item": [
        {
          "name": "GET commercial/companies/{national_id}/full-profile/",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/commercial/companies/{{national_id}}/full-profile/?idempotency_key={{$guid}}",
              "host": ["{{base_url}}"],
              "path": ["commercial", "companies", "{{national_id}}", "full-profile", ""],
              "query": [{ "key": "idempotency_key", "value": "{{$guid}}" }]
            },
            "description": "بسته کامل شرکت — هویت، وضعیت، نشانی، اعضا، صاحبان امضا، سهام‌داران، دسته‌ها، اینمادها، مجوزها و نشان‌های تجاری در یک فراخوانی. هزینه: مجموع اجزای موجود × ۰٫۸ (تخفیف ۲۰٪)."
          },
          "response": [
            {
              "name": "Success 200",
              "status": "OK",
              "code": 200,
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\"debit_transaction_id\":22013,\"total_charged\":50000,\"data\":{\"identity\":{\"id_code\":\"C0000001\",\"company_name\":\"شرکت نمونه\",\"national_id\":\"12345678901\"},\"active_status\":{\"is_active\":true},\"address\":null,\"board_members\":[],\"signatories\":[],\"capital_shares\":[],\"categories\":[],\"enamads\":[],\"licenses\":[],\"trademarks\":[]}}"
            }
          ]
        }
      ]
    }
  ]
}