Skip to content

Dispute Departments

Retrieving a Department by Code

Swagger Page

https://swagger-ui.aws-prod.billtrust.com/?urls.primaryName=Dispute%20Service%20v1#/DisputeDepartmentV1/get_v1_tenants__tenantId__departments_code__code_

Permission

Dispute Configuration : READ

Example Request

curl -X GET 'https://arc-aegis.billtrust.com/dispute/v1/tenants/{tenantId}/departments/code/{departmentCode}' \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'X-Billtrust-Api-Key: <API key value>'

Example Response

{
  "departmentId": "{departmentId}",
  "tenantId": "{tenantId}",
  "code": "{departmentCode}",
  "description": "Shipping",
  "createUser": "{userId}",
  "createDate": "2021-03-28T15:30:21.242Z",
  "updateUser": "{userId}",
  "updateDate": "2021-03-28T15:30:21.242Z"
}

Retrieving a List of Departments

Swagger Page

https://swagger-ui.aws-prod.billtrust.com/?urls.primaryName=Dispute%20Service%20v1#/DisputeDepartmentV1/get_v1_tenants__tenantId__departments

Permission

Dispute Configuration : READ

Example Request

curl -X GET 'https://arc-aegis.billtrust.com/dispute/v1/tenants/{tenantId}/departments' \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'X-Billtrust-Api-Key: <API key value>'

Example Response

[
    {
    "departmentId": "{departmentId}",
    "tenantId": "{tenantId}",
    "code": "SHIPDEPT",
    "description": "Shipping",
    "createUser": "{userId}",
    "createDate": "2021-03-28T15:30:21.242Z",
    "updateUser": "{userId}",
    "updateDate": "2021-03-28T15:30:21.242Z"
    },
    ...
]

Creating a Department

Swagger Page

https://swagger-ui.aws-prod.billtrust.com/?urls.primaryName=Dispute%20Service%20v1#/DisputeDepartmentV1/post_v1_tenants__tenantId__departments

Permission

Dispute Configuration : CREATE

Example Request

curl -X POST 'https://arc-aegis.billtrust.com/dispute/v1/tenants/{tenantId}/departments' \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'X-Billtrust-Api-Key: <API key value>' \
    -d '{ "code": "SHIPDEPT", "description": "Shipping" }'

Example Response

{
  "departmentId": "{departmentId}",
  "tenantId": "{tenantId}",
  "code": "SHIPDEPT",
  "description": "Shipping",
  "createUser": "{userId}",
  "createDate": "2021-03-28T15:30:21.242Z",
  "updateUser": "{userId}",
  "updateDate": "2021-03-28T15:30:21.242Z"
}

Updating a Department

Swagger Page

https://swagger-ui.aws-prod.billtrust.com/?urls.primaryName=Dispute%20Service%20v1#/DisputeDepartmentV1/put_v1_tenants__tenantId__departments__departmentId_

Permission

Dispute Configuration : UPDATE

Example Request

curl -X PUT 'https://arc-aegis.billtrust.com/dispute/v1/tenants/{tenantId}/departments/{departmentId}' \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'X-Billtrust-Api-Key: <API key value>' \
    -d '{ "description": "Shipping Department" }'

Example Response

{
  "departmentId": "{departmentId}",
  "tenantId": "{tenantId}",
  "code": "SHIPDEPT",
  "description": "Shipping Department",
  "createUser": "{userId}",
  "createDate": "2021-03-28T15:30:21.242Z",
  "updateUser": "{userId}",
  "updateDate": "2021-03-30T12:12:00.000Z"
}

Deleting a Department by ID

Swagger Page

https://swagger-ui.aws-prod.billtrust.com/?urls.primaryName=Dispute%20Service%20v1#/DisputeDepartmentV1/delete_v1_tenants__tenantId__departments__departmentId_

Permission

Dispute Configuration : DELETE

Example Request

curl -X DELETE 'https://arc-aegis.billtrust.com/dispute/v1/tenants/{tenantId}/departments/{departmentId}' \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'X-Billtrust-Api-Key: <API key value>' 

Deleting a Department by Code

Swagger Page

https://swagger-ui.aws-prod.billtrust.com/?urls.primaryName=Dispute%20Service%20v1#/DisputeDepartmentV1/delete_v1_tenants__tenantId__departments_by_code__departmentCode_

Permission

Dispute Configuration : DELETE

Example Request

curl -X DELETE 'https://arc-aegis.billtrust.com/dispute/v1/tenants/{tenantId}/departments/by-code/{departmentCode}' \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'X-Billtrust-Api-Key: <API key value>'