Set status

Changes the status of an application

End point

/api/applicationapi/setstatus

Request format

POST

Request content

The request body should be formatted as XML, see below.

<?xml version=""1.0"" encoding=""UTF-8""?>
<application>
  <id></id>
  <status></status>
  <reply></reply>
  <rejectreason></rejectreason>
</requisition>
Property Name Required Description 
id
 Yes

Id of application

 
status
 Yes

The status to set the application to. The following values are available:

0 - Pending

1 - Accepted

2 - Rejected

4 - Approved

5 - RequestAdditions

 
reply
 No

Reply text for status change

 
rejectreason
 No

If status is set to 2 (rejected), this can be used to specify why the application was rejected

Possible values:

0 - Rate is to high

1 - Overqualified

2 - Underqualified

3 - Not matching requirements

4 - Other

Response Messages

The Brainville API will respond to the HTTP POST in the following manner:

Success

If the post was successful, the response will be HTTP Status 200 (OK).


Failure

Incorrect authentication – The service will return HTTP Status 401 (Unauthorized). This
will be returned if either API User Key or API Sender Key is incorrect
Bad XML – If the XML is malformed, a HTTP Status 400 (Bad Request) will be returned.
Incorrect application Id – a HTTP Status 404 (Not found) will be returned