Headers

Header name Description
Cookie
required
Login session cookie
Provision
required
Web/Mobile/API Provision UUID

Returns

Code: 200

Description:

List of ministers

Param name Description
id
required

ID

Validations:

  • Must be a Integer

last_name
required

Last name

Validations:

  • Must be a String

first_name
required

First name

Validations:

  • Must be a String

middle_name
required

Middle name

Validations:

  • Must be a String

title
required

Title

Validations:

  • Must be a String

suffix_name
required

Suffix

Validations:

  • Must be a String

greeting
required

Greeting

Validations:

  • Must be a String

order_of_ministry_id
required

Order of Ministry ID

Validations:

  • Must be a Integer

order_of_ministry_desc
required

Order of Ministry description

Validations:

  • Must be a String

professional_code_id
required

Professional Code ID

Validations:

  • Must be a Integer

professional_code_desc
required

Professional Code description

Validations:

  • Must be a String

region_id
required

Region ID

Validations:

  • Must be a Integer

region_desc
required

Region description

Validations:

  • Must be a String

address1
required

Address line 1

Validations:

  • Must be a String

address2
required

Address line 2

Validations:

  • Must be a String

address3
required

Address line 3

Validations:

  • Must be a String

city
required

City

Validations:

  • Must be a String

state
required

State

Validations:

  • Must be a String

zip
required

ZIP/Postal Code

Validations:

  • Must be a String

country
required

Country Code

Validations:

  • Must be a String

has_standing
required

Minister has standing

Validations:

  • Must be one of: t, f, true, false, 1, 0, y, n, yes, no.

phones
required

Minister Phone numbers

Validations:

  • Must be a Hash

phones[phones]
optional

List of Phone numbers

Validations:

  • Must be an Array of nested elements

phones[phones][type]
optional

Phone number type

Validations:

  • Must be a String

phones[phones][phone]
optional

Phone number

Validations:

  • Must be a String

emails
required

Minister Emails

Validations:

  • Must be a Hash

emails[emails]
optional

List of Email addresses

Validations:

  • Must be an Array of nested elements

emails[emails][type]
optional

Email address type

Validations:

  • Must be a String

emails[emails][email]
optional

Email address

Validations:

  • Must be a String

positions
required

Minister Positions

Validations:

  • Must be a Hash

positions[positions]
optional

List of Positions

Validations:

  • Must be an Array of nested elements

positions[positions][position]
optional

Position description

Validations:

  • Must be a String

positions[positions][pin]
optional

Position PIN

Validations:

  • Must be a String

positions[positions][historical]
optional

Historical Position status

Validations:

  • Must be one of: t, f, true, false, 1, 0, y, n, yes, no.

positions[positions][begin_date]
optional

Position begin date

Validations:

  • Must be a String

positions[positions][end_date]
optional

Position end date

Validations:

  • Must be a String

ethnic_codes
required

Minister Ethnic Codes

Validations:

  • Must be a Hash

ethnic_codes[ethnic_codes]
optional

List of Ethnic Codes

Validations:

  • Must be an Array of nested elements

ethnic_codes[ethnic_codes][id]
optional

Ethnic Code ID

Validations:

  • Must be a Integer

ethnic_codes[ethnic_codes][description]
optional

Ethnic Code description

Validations:

  • Must be a String

Code: 401

Description:

Unauthorized

Param name Description
errors
required

Errors returned by request

Validations:

  • Must be an Array of nested elements

errors[error]
required

Why the request failed

Validations:

  • Must be a String

errors[status]
required

HTTP response code

Validations:

  • Must be a Integer

Code: 404

Description:

Not Found

Param name Description
errors
required

Errors returned by request

Validations:

  • Must be an Array of nested elements

errors[error]
required

Why the request failed

Validations:

  • Must be a String

errors[status]
required

HTTP response code

Validations:

  • Must be a Integer

Code: 422

Description:

Unprocessable Entity

Param name Description
errors
required

Errors returned by request

Validations:

  • Must be an Array of nested elements

errors[error]
required

Why the request failed

Validations:

  • Must be a String

errors[status]
required

HTTP response code

Validations:

  • Must be a Integer

Code: 500

Description:

Internal Server Error

Param name Description
errors
required

Errors returned by request

Validations:

  • Must be an Array of nested elements

errors[error]
required

Why the request failed

Validations:

  • Must be a String

errors[status]
required

HTTP response code

Validations:

  • Must be a Integer

Errors

Code Description
404 Data source query failed
422 Invalid parameter(s)
422 Provision header missing
422 Invalid provision
422 Under maintenance
422 Incorrect host for provision
422 Establishing session failed
422 Privilege to perform the action was not found
422 Not logged in
422 Provision does not match logged in provision
422 Invalid custom version
500 No connection to data source

Examples

GET /api/v2/doc/ministers
422
{
  "errors": [
    {
      "error": "You do not have permission to perform this action.",
      "status": 422
    }
  ]
}
GET /api/v2/doc/ministers
200
[
  {
    "id": "2826",
    "last_name": "Styles",
    "first_name": "Allen",
    "middle_name": "James",
    "title": "Champion",
    "suffix_name": "Jr.",
    "greeting": "Hello AJ!",
    "order_of_ministry_id": "361",
    "order_of_ministry_desc": "Current Status",
    "professional_code_id": "128",
    "professional_code_desc": "Prospective",
    "region_id": "0",
    "region_desc": "",
    "address1": "Test",
    "address2": "Address 2",
    "address3": "",
    "city": "Versailles",
    "state": "KY",
    "zip": "40383",
    "country": "US",
    "has_standing": true,
    "phones": {
      "phones": [
        {
          "type": "Mobile phone",
          "phone": "0123456789"
        },
        {
          "type": "Mobile phone",
          "phone": "9876543210"
        }
      ]
    },
    "emails": {
      "emails": [
        {
          "type": "E-mail address",
          "email": "aj@test.com"
        },
        {
          "type": "E-mail address",
          "email": "secondaj@gmail.com"
        }
      ]
    },
    "positions": null,
    "ethnic_codes": {
      "ethnic_codes": []
    }
  }
]