Skip to content
/
List SubContract Orders (...

FuelU2 Customer API (1.0.0)

API for handling customer data, relationships, and order interactions within the FuelU2 network.

Download OpenAPI description
customer.json
customer.yaml
Overview
FuelU2 API Support

support@fuelu2.com

License

MIT

Languages
Servers
Mock server

https://developers.fuelu2.com/_mock/apis/customer/

Production server

https://api.fuelu2.com/

Authentication

Operations

Orders

Operations

Drivers

Operations

Vehicles

Operations

Subcontracts

Operations

Create/Edit a SubContract

Request

Creates a new subcontract or updates an existing one. The id field can be omitted or set to null when adding a new subcontract.

Security
bearerAuth
Bodyapplication/jsonrequired
idstring(uuid)
Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
markupnumber
Example: 0
namestring
Example: "Example SubContract"
driverIdsArray of strings(uuid)
Example: ["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
userIdsArray of strings
Example: ["string"]
vehicleIdsArray of strings(uuid)
Example: ["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
curl -i -X POST \
  https://developers.fuelu2.com/_mock/apis/customer/SubContracts \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "markup": 0,
    "name": "Example SubContract",
    "driverIds": [
      "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    ],
    "userIds": [
      "string"
    ],
    "vehicleIds": [
      "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    ]
  }'

Responses

Successfully created or updated the subcontract

Bodyapplication/json
successboolean
Example: true
messagestring
Example: "SubContract created successfully"
Response
application/json
{
  "success": true,
  "message": "SubContract created successfully"
}

Get a Paged Subcontracts List

Request

Retrieves a paginated list of subcontracts with optional filters for customer, driver, vehicle, and search text.

Security
bearerAuth
Query
Pageinteger(int32)

Page number for pagination

Example: Page=1
PageSizeinteger(int32)

Number of items per page

Example: PageSize=20
CustomerIdstring(uuid)

Filter by single customer ID

CustomerIdsArray of strings

Filter by multiple customer IDs

DriverIdsArray of strings

Filter by driver IDs

UserIdsArray of strings

Filter by user IDs

VehicleIdsArray of strings

Filter by vehicle IDs

Textstring

Free-text search across subcontract names

curl -i -X GET \
  'https://developers.fuelu2.com/_mock/apis/customer/SubContracts/paged?Page=1&PageSize=20&CustomerId=497f6eca-6276-4993-bfeb-53cbbbba6f08&CustomerIds=string&DriverIds=string&UserIds=string&VehicleIds=string&Text=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successfully retrieved subcontract list

Bodyapplication/json
itemsArray of objects
pageinteger
pageCountinteger
totalinteger
Response
application/json
{
  "items": [
    { … }
  ],
  "page": 0,
  "pageCount": 0,
  "total": 0
}

Adjust Subcontract Markups

Request

Adjusts the markup for a specific product within a subcontract. The subContractId is required to identify which subcontract’s markup is being modified.

Security
bearerAuth
Bodyapplication/jsonrequired
adjustmentnumber
Example: 0
productIdstring(uuid)
Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
subContractIdstring(uuid)required
Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
curl -i -X POST \
  https://developers.fuelu2.com/_mock/apis/customer/SubContractMarkups \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "adjustment": 0,
    "productId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "subContractId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }'

Responses

Successfully adjusted subcontract markup

Bodyapplication/json
successboolean
Example: true
messagestring
Example: "Markup adjustment saved successfully"
Response
application/json
{
  "success": true,
  "message": "Markup adjustment saved successfully"
}

Place Subcontract Order

Request

Creates a new subcontract order. The customerId and subContractId are automatically assigned on the backend.

Security
bearerAuth
Bodyapplication/jsonrequired
idstring(uuid)

Optional when creating a new order

orderDatestring(date-time)
Example: "2025-10-14T06:15:00.000Z"
referencestring
Example: "PO-456"
itemsArray of objects
curl -i -X POST \
  https://developers.fuelu2.com/_mock/apis/customer/SubContractOrders \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "orderDate": "2025-10-14T06:15:00.000Z",
    "reference": "PO-456",
    "items": [
      {
        "productId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "quantity": 1000,
        "price": 25.5
      }
    ]
  }'

Responses

Successfully placed subcontract order

Bodyapplication/json
idstring(uuid)
Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
messagestring
Example: "Subcontract order created successfully"
Response
application/json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "message": "Subcontract order created successfully"
}

List SubContract Orders (Paged)

Request

Retrieves a paginated list of subcontract orders. The customerId and subContractId are set automatically on the backend.

Security
bearerAuth
Query
Pageinteger(int32)

Page number

PageSizeinteger(int32)

Number of items per page

Textstring

Search text

Statusstring

Optional order status filter

curl -i -X GET \
  'https://developers.fuelu2.com/_mock/apis/customer/SubContractOrders/paged?Page=0&PageSize=0&Text=string&Status=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successful response

Bodyapplication/json
itemsArray of objects
pageinteger
Example: 1
pageCountinteger
Example: 10
totalinteger
Example: 100
Response
application/json
{
  "items": [
    { … }
  ],
  "page": 1,
  "pageCount": 10,
  "total": 100
}

Get Proforma

Request

Retrieves a proforma document using the order's customerSubContractInvoiceId.

Security
bearerAuth
Path
idstringrequired

The unique ID of the file or proforma

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
curl -i -X GET \
  https://developers.fuelu2.com/_mock/apis/customer/Files/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
string
Response
application/json
"File retrieved successfully"