Skip to main content
Accounts represent your clients or organizations in FieldIU. Use these endpoints to create new accounts or retrieve existing ones.

​
Create Account

Creates a new account record in FieldIU.

​
Request Body

​
name
string
Account display name
​
email
string
Account email address
​
accountType
integer
Account type identifier. See NullableOfaccount_ha_accounttype for valid values
​
legalName
string
Legal registered name of the organization
​
defaultPaymentTerms
integer
Default payment terms. See NullableOfaccount_ha_defaultpaymentterms for valid values
​
trnNumber
string
Tax registration number
​
licenseNumber
string
Business license number
​
businessPhone
string
Primary business phone number
​
buildingLocation
string
Building or location name
​
street1
string
Street address line 1
​
street2
string
Street address line 2
​
city
string
City
​
postalCode
string
Postal / ZIP code
​
state
string
State or province
​
country
string
Country

​
Example Request

curl -X POST https://integration.fieldiu.online/api/v1/accounts \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-ORG-ID: your_org_id" \
  -d '{
    "name": "Acme Corporation",
    "email": "billing@acme.com",
    "accountType": 1,
    "legalName": "Acme Corporation LLC",
    "businessPhone": "+1-555-000-1234",
    "street1": "123 Main Street",
    "city": "Dubai",
    "country": "UAE"
  }'

const response = await fetch('https://integration.fieldiu.online/api/v1/accounts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'your_api_key',
    'X-ORG-ID': 'your_org_id'
  },
  body: JSON.stringify({
    name: 'Acme Corporation',
    email: 'billing@acme.com',
    accountType: 1,
    legalName: 'Acme Corporation LLC',
    businessPhone: '+1-555-000-1234',
    street1: '123 Main Street',
    city: 'Dubai',
    country: 'UAE'
  })
});

​
Response

200 OK — Account created successfully.

​
List Accounts

Returns a paginated list of all accounts in your organization.

​
Query Parameters

​
page
integer
Page number for pagination (1-based)

​
Example Request

curl -X GET "https://integration.fieldiu.online/api/v1/accounts?page=1" \
  -H "X-API-KEY: your_api_key" \
  -H "X-ORG-ID: your_org_id"

const response = await fetch('https://integration.fieldiu.online/api/v1/accounts?page=1', {
  headers: {
    'X-API-KEY': 'your_api_key',
    'X-ORG-ID': 'your_org_id'
  }
});

​
Response

200 OK — Returns a list of account objects.

​
Get Account by ID

Returns a single account record by its unique identifier.

​
Path Parameters

​
id
string
required
The unique identifier of the account

​
Example Request

curl -X GET https://integration.fieldiu.online/api/v1/accounts/abc-123 \
  -H "X-API-KEY: your_api_key" \
  -H "X-ORG-ID: your_org_id"

const response = await fetch('https://integration.fieldiu.online/api/v1/accounts/abc-123', {
  headers: {
    'X-API-KEY': 'your_api_key',
    'X-ORG-ID': 'your_org_id'
  }
});

​
Response

200 OK — Returns the account object for the given ID.