Bijack Loadboard API

The Loadboard API from Bijack — 1 operation(s) for loadboard.

Operations 1

POST /loadboard/public/api/shipper_leads.php Save discovered shipper leads #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/bijack-ir:bijack-ir-loadboard-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bijack-ir-loadboard-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Bijack Shipper Lead Discovery Loadboard API
  version: 1.1.0
  description: API for saving GPT-discovered shipper and cargo-owner leads into Bijack back office.
servers:
- url: https://bijack.ir
  description: Bijack production
tags:
- name: Loadboard
paths:
  /loadboard/public/api/shipper_leads.php:
    post:
      operationId: saveShipperLeads
      summary: Save discovered shipper leads
      description: Save one discovery batch containing likely cargo-owner companies, contacts, cargo profiles, source evidence, and trace/reference metadata.
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - companies
              properties:
                source_reference_code:
                  type: string
                  description: Human-readable trace code generated by Bijack back office, e.g. SP-20260627-A1B2C3.
                  maxLength: 120
                source_pattern_key:
                  type: string
                  description: Stable SHA1 key for the seasonal pattern or source prompt.
                  maxLength: 40
                idempotency_key:
                  type: string
                  description: Unique retry-safe key for this discovery batch.
                  maxLength: 160
                query_text:
                  type: string
                  description: Original or generated discovery prompt.
                origin_text:
                  type: string
                  description: Extracted origin, city, plant, mine, or production area.
                cargo_text:
                  type: string
                  description: Extracted cargo or goods name.
                source:
                  type: string
                  default: custom_gpt
                source_client:
                  type: string
                  default: bijack-shipper-lead-gpt
                requested_by:
                  type: string
                  description: Optional operator/user name.
                companies:
                  type: array
                  minItems: 1
                  maxItems: 30
                  items:
                    $ref: '#/components/schemas/ShipperLeadCompany'
      responses:
        '200':
          description: Leads saved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  batch_id:
                    type: integer
                  duplicate_batch:
                    type: boolean
                  received:
                    type: integer
                  created:
                    type: integer
                  duplicates:
                    type: integer
                  source_reference_code:
                    type: string
                  source_pattern_key:
                    type: string
                  idempotency_key:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
        '400':
          description: Invalid JSON payload.
        '401':
          description: Unauthorized or missing token.
        '413':
          description: Payload too large.
        '422':
          description: Insert failed or validation failed.
      tags:
      - Loadboard
components:
  schemas:
    ShipperLeadSource:
      type: object
      additionalProperties: false
      properties:
        source_url:
          type: string
        source_title:
          type: string
        source_note:
          type: string
        evidence_type:
          type: string
    ShipperLeadCargoProfile:
      type: object
      additionalProperties: false
      properties:
        cargo_type:
          type: string
        cargo_subtype:
          type: string
        origin_text:
          type: string
        destination_text:
          type: string
        loader_type:
          type: string
        confidence_percent:
          type: integer
          minimum: 0
          maximum: 100
        description:
          type: string
    ShipperLeadContact:
      type: object
      additionalProperties: false
      properties:
        person_name:
          type: string
        position_title:
          type: string
        department:
          type: string
        phone_1:
          type: string
        phone_2:
          type: string
        mobile_1:
          type: string
        mobile_2:
          type: string
        email:
          type: string
        contact_quality_percent:
          type: integer
          minimum: 0
          maximum: 100
        description:
          type: string
    ShipperLeadCompany:
      type: object
      additionalProperties: false
      properties:
        company_name:
          type: string
        company_national_id:
          type: string
          description: Iranian legal entity national ID.
        registration_number:
          type: string
        economic_code:
          type: string
        ceo_name:
          type: string
        address:
          type: string
        province_text:
          type: string
        city_text:
          type: string
        origin_text:
          type: string
        website:
          type: string
        description:
          type: string
        match_confidence_percent:
          type: integer
          minimum: 0
          maximum: 100
        data_quality_percent:
          type: integer
          minimum: 0
          maximum: 100
        confidence_reason:
          type: string
        status:
          type: string
          enum:
          - new
          - needs_review
          - reviewed
          - qualified
          - rejected
          - duplicate
          - contacted
          - converted
          default: new
        contacts:
          type: array
          items:
            $ref: '#/components/schemas/ShipperLeadContact'
        cargo_profiles:
          type: array
          items:
            $ref: '#/components/schemas/ShipperLeadCargoProfile'
        sources:
          type: array
          items:
            $ref: '#/components/schemas/ShipperLeadSource'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer