Fleet Management API Beta

Sections

Theme switcher

Create a Card

Header Parameters

user_idstring

Optional audit field that indicates the User that performed a change. This field cannot be updated directly without appropriate permission - it is automatically set to the clientId of the authenticated User making the request.

Authorizationstring

Body Parameters

account_idstring Required

Account Id.

batch_order_numberinteger

Batch order number associated with card creation. Use this value to group cards together and order them as a single batch. This value can be set by the user on the card creation request.

card_addressobject

Address used in card orders and saved on the card for reuse.

Show child attributes

card_orderobject

Data required to order cards that will be shipped to an address other than the default account shipping address.

Show child attributes

card_profile_idstring Required

Card Profile Id. Card profiles are used to set default values for cards. Like embossing and usage type.

department_idstring

Id of department.

driverobject

A driver will be created and associated to this card with this driver information if this is a driver card or 1:1 plus card. If no information is provided, and this is a driver card, a driver will be created with default information and associated this card. Only required for Driver cards or 1:1 plus cards.

Show child attributes

embossingobject

Show child attributes

employee_numberstring

Often used to store a unique identifier for the employee assigned to the card.

ev_requestedboolean

Request electric vehicle charging access.

partner_identifierstring

An alpha-numeric identifier used by partners to link to their internal systems. Can be 5, 10 or 15 characters depending on account set up.

produce_cardboolean

This field should be set to true unless your company produces its own cards or you are doing a batch order.

Default value
true
purchase_control_idstring

Purchase Control Id. Also known as Purchase Control id. Used to set control limits for cards. If no value is provided the default value for the account will be used.

reference_idstring

Reference Id. Place for customers to add custom data.

use_address_on_cardboolean

Indicates if the card should be sent to a shipping address that will be stored for reuse.

user_defined_fieldsarray

A list of User Defined Fields.

Max items
20

Show child attributes

vehicleobject

A vehicle will be created and associated to this card with this vehicle information. If no information is provided and this is an asset card a vehicle will be created with default information and associated this card. Only required for Vehicle (Asset) cards or 1:1 plus cards.

Show child attributes

Response

201
Object

The card that was created.

Response Attributes

_linksobject

HATEOAS links related to the card.

Show child attributes

account_idstring

Account Id.

account_namestring

Name of the account.

batch_order_numberinteger

Batch order number associated with card creation. Use this value to group cards together and order them as a single batch. This value can be set by the user on the card creation request.

card_addressobject

Address used in card orders and saved on the card for reuse.

Show child attributes

card_idstring

Card Id.

card_lockedboolean

Card Locked Flag

card_numberstring

Card Number.

card_profile_idstring

Card Profile Id.

card_profile_namestring

Card Profile Name.

card_suffixinteger

Last digit of the MagStrip number.

card_typestring

Valid Card Types:
Custom Control Fuel Only Fuel and Oil Unrestricted WEX Edge CarAdvise

departmentobject

Department object.

Show child attributes

design_codestring

Design code used determine properties on the card.

driver_idstring

Driver Id.

driver_prompt_idstring

Prompt Id for the driver.

embossed_numberstring

Embossed Number. Used by businesses to store special card numbers.

embossingarray

Used by businesses to store vehicle information or other information that is important to them. The embossing can be customer defined or linked to other attributes on other entities based on the embossing specification defined by the card profile.

Max items
3

Show child attributes

ev_requestedboolean

Request electric vehicle charging access.

ev_requested_datestring

The date electric vehicle charging access was requested. Format: YYYY-MM-DDTHH:MM:SSZ.

expiration_datestring

The date the card expires. Format: YYYY-MM-DDTHH:MM:SSZ

last_issue_datestring

Date card was last issued. Format: YYYY-MM-DDTHH:MM:SSZ.

last_updatedstring

Date card was last changed. Format: YYYY-MM-DDTHH:MM:SSZ.

license_plate_numberstring

License Plate Number.

mag_strip_numberstring

Magnetic Strip Number.

order_idstring

Order Id.

original_card_idstring
partner_identifierstring

An alpha-numeric identifier used by partners to link to their internal systems. Can be 5, 10 or 15 characters depending on account set up.

pos_display_promptstring

Point of Sale prompting for display.

pos_override_promptstring

Point of Sale prompting override.

purchase_control_idstring

Purchase Control Id.

purchase_control_namestring

Purchase Control Name.

reference_idstring

Reference Id. Place for customers to throw goo...

renewal_flagboolean

Indicates if the card is eligible for renewal.

renewal_periodstring

Renewal period.

rfidsarray

List of RFID's associated to the card.

Show child attributes

statusstring

The status of the card.

status_reasonstring

Describes the reason for the card status. A card may be in suspended status because it was reported lost.

usage_typestring

Valid usage types: Asset Driver Driver 1:1 Driver 1:1 Plus Site Usage Vehicle 1:1 Vehicle 1:1 Plus

use_address_on_cardboolean

Indicates if the card should be sent to a shipping address that will be stored for reuse.

user_defined_fieldsarray

User Defined Fields.

Max items
20

Show child attributes

vehicle_customer_idstring

Vehicle Customer Id.

vehicle_descriptionstring

Vehicle Description.

vehicle_idstring

Vehicle Id.

vehicle_prompt_idstring

Prompt Id for the vehicle.

vinstring

Vehicle Identification Number.

400
Object

Invalid request body

Response Attributes

detailed_messagestring
http_statusstring
messagestring
timestampstring
403
Object

The supplied user does not have access to the associated account(s)

Response Attributes

detailed_messagestring
http_statusstring
messagestring
timestampstring
Was this section helpful?

POST

/

Select
1

Response

Was this section helpful?