Bijack Loadboard API
The Loadboard API from Bijack — 1 operation(s) for loadboard.
The Loadboard API from Bijack — 1 operation(s) for loadboard.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/bijack-ir:bijack-ir-loadboard-api"
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.
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: 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