Contacts

get contacts

GEThttps://ushahididocs.api.ushahidi.io/api/v3/contacts

Query parameters

Response

200401

OK

Body

application/json

count*integer (int32)

results*getcontacts_results (object)

limit*nullable string

offset*integer (int32)

order*string

orderby*string

curr*string

next*string

prev*string

total_count*integer (int32)

Request

JavaScriptCurl

const response = await fetch('https://ushahididocs.api.ushahidi.io/api/v3/contacts', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "count": 9,
  "results": [
    {
      "id": 1,
      "url": "http://localhost:8000/api/v3/contacts/1",
      "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
      },
      "type": "phone",
      "contact": "123456789",
      "created": "1970-01-01T00:00:00+00:00",
      "can_notify": false,
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    },
    {
      "id": 2,
      "url": "http://localhost:8000/api/v3/contacts/2",
      "type": "email",
      "contact": "[e-mail]",
      "created": "1970-01-01T00:00:00+00:00",
      "can_notify": false,
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    },
    {
      "id": 3,
      "url": "http://localhost:8000/api/v3/contacts/3",
      "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
      },
      "type": "phone",
      "contact": "123456789",
      "created": "1970-01-01T00:00:00+00:00",
      "updated": "2022-11-02T15:35:51+00:00",
      "can_notify": false,
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    },
    {
      "id": 4,
      "url": "http://localhost:8000/api/v3/contacts/4",
      "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
      },
      "type": "email",
      "contact": "[e-mail]",
      "created": "1970-01-01T00:00:00+00:00",
      "can_notify": false,
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    },
    {
      "id": 5,
      "url": "http://localhost:8000/api/v3/contacts/5",
      "type": "phone",
      "contact": "099999999",
      "created": "1970-01-01T00:00:00+00:00",
      "can_notify": false,
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    },
    {
      "id": 6,
      "url": "http://localhost:8000/api/v3/contacts/6",
      "type": "phone",
      "contact": "99999991",
      "created": "1970-01-01T00:00:00+00:00",
      "can_notify": false,
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    },
    {
      "id": 7,
      "url": "http://localhost:8000/api/v3/contacts/7",
      "type": "phone",
      "contact": "99999992",
      "created": "1970-01-01T00:00:00+00:00",
      "can_notify": false,
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    },
    {
      "id": 8,
      "url": "http://localhost:8000/api/v3/contacts/8",
      "type": "phone",
      "contact": "59891333224",
      "created": "1970-01-01T00:00:00+00:00",
      "can_notify": false,
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    },
    {
      "id": 9,
      "url": "http://localhost:8000/api/v3/contacts/9",
      "type": "phone",
      "contact": "59891333225",
      "created": "1970-01-01T00:00:00+00:00",
      "can_notify": false,
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    }
  ],
  "offset": 0,
  "order": "asc",
  "orderby": "id",
  "curr": "http://localhost:8000/api/v3/contacts?orderby=id&order=asc&offset=0",
  "next": "http://localhost:8000/api/v3/contacts?orderby=id&order=asc&offset=0",
  "prev": "http://localhost:8000/api/v3/contacts?orderby=id&order=asc&offset=0",
  "total_count": 9
}

add contact

POST https://ushahididocs.api.ushahidi.io/api/v3/contacts

Request Body

Name	Type	Description
user_id	Integer	The user identifier
country_code	String	Country code
can_notify	Boolean	Set True to enable contact notification and False to disable
contact	String	Contact number
type	String	The type of contact e.g. "phone"
data_source	String	The data source

200: OK

{
    "id": 1,
    "url": "http://localhost:8000/api/v3/contacts/1",
    "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
    },
    "data_source": null,
    "type": "phone",
    "contact": "123456789",
    "created": "1970-01-01T00:00:00+00:00",
    "updated": null,
    "can_notify": false,
    "country_code": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}

get contact

GEThttps://ushahididocs.api.ushahidi.io/api/v3/contacts/1

Response

200401404

OK

Body

application/json

id*integer (int32)

url*string

user*createsavedsearch_user (object)

Example: "{\"id\":1,\"url\":\"http://localhost:8000/api/v3/users/1\"}"

data_source*nullable string

type*string

contact*string

created*string

updated*nullable string

can_notify*boolean

country_code*nullable string

allowed_privileges*array of string

Request

JavaScriptCurl

const response = await fetch('https://ushahididocs.api.ushahidi.io/api/v3/contacts/1', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "id": 1,
  "url": "http://localhost:8000/api/v3/contacts/1",
  "user": {
    "id": 1,
    "url": "http://localhost:8000/api/v3/users/1"
  },
  "type": "phone",
  "contact": "123456789",
  "created": "1970-01-01T00:00:00+00:00",
  "can_notify": false,
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search"
  ]
}

edit contact

PUT https://ushahididocs.api.ushahidi.io/api/v3/contacts/3

Request Body

Name	Type	Description
user_id	Integer	The user identifier
country_code	String	Country code
can_notify	Boolean	Set True to enable contact notification and False to disable
contact	String	Contact number
type	String	The type of contact e.g. "phone"
data_source	String	The data source

200: OK

{
    "id": 1,
    "url": "http://localhost:8000/api/v3/contacts/1",
    "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
    },
    "data_source": null,
    "type": "phone",
    "contact": "123456789",
    "created": "1970-01-01T00:00:00+00:00",
    "updated": null,
    "can_notify": false,
    "country_code": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}

delete contact

DELETEhttps://ushahididocs.api.ushahidi.io/api/v3/contacts/9

Response

200401404

OK

Body

application/json

id*integer (int32)

url*string

user_id*nullable string

data_source*nullable string

type*string

contact*string

created*string

updated*nullable string

can_notify*boolean

country_code*nullable string

allowed_privileges*array of string

Request

JavaScriptCurl

const response = await fetch('https://ushahididocs.api.ushahidi.io/api/v3/contacts/9', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

{
  "id": 10,
  "url": "http://localhost:8000/api/v3/contacts/10",
  "type": "phone",
  "contact": "59891333226",
  "created": "1970-01-01T00:00:00+00:00",
  "can_notify": false,
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search"
  ]
}