API CLIENT REGISTRATION

Please provide your name and email address to request for Gazette API client registration.
Once requested, an email will be sent to the provided email to confirm the request.




HELP

* Date & Time fields' format (PHP): Y-m-d H:i:s
* All responses are in JSON format.
* Attachments include a direct public Google Cloud Storage URL in the url field.
* Attachment download URL format: https://storage.googleapis.com/gazette.gov.mv/docs/iulaan/{attachment_id}.{file_type}


Latest 'Iulaan' list

https://api.gazette.gov.mv/iulaan
https://api.gazette.gov.mv/iulaan/page/{no}

Response: json
Format:

{
	data: [],
	meta: [
		page_number: "",
		records_per_page: "",
		number_of_pages: "",
		total_number_of_records: ""
	]
}


Fetch 'Iulaan'

https://api.gazette.gov.mv/iulaan/{id}

Response: json
Format:

{
	iulaan_id: "", 
	iulaan_date: "", 
	lang: "",..., 
	job_details: [], 
	attachments:[], 
	linked_iulaans:[]
}

  • job_details: [{ designation: "", job_type: "", job_type_slug: "", quantity: "", details: "" },…]
  • *job_details will be available for ‘vazeefaa iulaan’ only

  • attachments: [{ attachment_id: "", description: "", file_size: "", file_type: "", url: "" }, ...]
  • attachments:
    [
        {
            "attachment_id": 312892,
            "description": "Attachment document",
            "file_size": 245678,
            "file_type": "pdf",
            "url": "https://storage.googleapis.com/gazette.gov.mv/docs/iulaan/312892.pdf"
        }
    ]

    The url field provides a direct public Google Cloud Storage link to the attachment. The file extension is determined by file_type.

  • linked_iulaans: [{iulaan_id: "", title: "", number: ""},…]

List 'Iulaan' by Type

https://api.gazette.gov.mv/iulaan/type/{slug}
https://api.gazette.gov.mv/iulaan/type/{slug}/page/{no}

Response: json
Format:

{
	data: [],
	meta: [
		page_number: "",
		records_per_page: "",
		number_of_pages: "",
		total_number_of_records: ""
	]
}

Available iulaan type slugs:-
  • masakkaiy
  • gannan-beynunvaa
  • kuyyah-dhinun
  • kuyyah-hifun
  • vazeefaa
  • thamreenu
  • neelan
  • aanmu-mauloomaathu
  • dhennevun
  • mubaaraai
  • noos-bayaan
  • insurance

List 'Vazeefaa Iulaan' by Job Category (Job Type)

https://api.gazette.gov.mv/iulaan/type/vazeefaa/category/{job-type-slug}
https://api.gazette.gov.mv/iulaan/type/vazeefaa/category/{job-type-slug}/page/{no}

Response: json
Format:

{
	data: [],
	meta: [
		page_number: "",
		records_per_page: "",
		number_of_pages: "",
		total_number_of_records: ""
	]
}

Available job type slugs:-
  • administration
  • public-relations
  • construction
  • education
  • finance
  • health-care
  • human-resource
  • information-technology
  • insurance
  • publishing-and-journalism
  • transport
  • legal
  • technical
  • customer-service
  • maintenance
  • support-staff
  • mechanical
  • management

View Unpublished 'Iulaan' List

https://api.gazette.gov.mv/iulaan/unpublished

Response: json
Format:

[
	{
		iulaan_id: ""
	},
	{
		iulaan_id: ""
	}
]

Always check unpublished 'Iulaan' as a previously fetched 'Iulaan" could be unpublished at a later time.