Skip to main content

Get trucker by taxid

GET 
/company/truckers/filterByTaxid/:taxid

Search for a carrier by their tax identification (DNI/NIE/CIF).

Use Case:

  • Quick search by identity document
  • Existence verification before creation
  • Query from external systems by taxid

Taxid Format:

  • Spain: DNI (12345678A), NIE (X1234567A), CIF (B12345678)
  • Length: 6-9 characters
  • Stored in uppercase

Response:

  • Returns the carrier's complete profile
  • Includes all details (parseFleetDetail)

Responses:

  • 200 OK: Carrier found
  • 404 Not Found: No carrier exists with that taxid

Security Note: This endpoint requires multitenant middleware but does not verify company membership. Consider adding additional validation.

Request​

Responses​

Carrier found