Skip to content

Organisation

Jump to bottom
Francisco Yedro edited this page Nov 7, 2020 · 14 revisions

An organisation is a legal entity involved in a contracting process. If a contracting process represents a contract arranged by the department or branch of a larger organisation, the legal entity (usually the registered organisation) should be described with details of the branch or department given in the name, address and contact point as relevant.

From the knowledge graph a complete list, or the information of a particular organisation, can be obtained, including the list of awards or contracting process. These are the four resources that have been implemented to fulfil these requirements:

GET /organisation: This returns the list of all the organisations included in the knowledge graph. The list is displayed in JSON format and consists of the following model schema:

MODEL SCHEME FIELDS
{
"id": xsd:string,
"legalName": xsd:string,
"jurisdiction": xsd:string
}
  • “id” stands for identifier for the organisation.
  • “legalName” stands for the legally name registered of the organisation.
  • “jurisdiction” stands for the jurisdiction which the organisation belongs to.

Example of use: http://data.tbfy.eu/kg-api/organisation

GET /organisation/{id}: This returns the whole information included in the knowledge graph of a specific organisation. The list is displayed in JSON format and consists of the following model schema:

MODEL SCHEME FIELDS
{
"id": xsd:string,
“legalName”: xsd:string,
“jurisdiction”: xsd:string,
“foundingDate”: xsd:dateTime,
“dissolutionDate”: xsd:dateTime,
“numberOfEmployees”: xsd:integer,
“activity”: xsd:string,
“status”: xsd:string,
“type”: xsd:string,
“fullAddress”:
{
“address”: xsd:string,
“postCode”: xsd:string,
“postName”: xsd:string,
“thoroughfare”: xsd:string
}
}
  • “id” stands for identifier for the organisation.
  • “legalName” stands for the legally name registered of the organisation.
  • “jurisdiction” stands for the jurisdiction which the organisation belongs to.
  • “dissolutionDate” stands for the date of dissolution of the organisation (if any).
  • “numberOfEmployees” stands for the number of employees of the organisation.
  • “activity” stands for a brief description of the activity of the organisation.
  • “status” stands for the current condition of the organisation.
  • “type” stands for the type of the organisation such as private, public, etc.
  • “fullAddress” stands for the address of the organisation. This may be the legally registered address of the organisation, or may be a correspondence address for this particular contracting process. Consists of:
    • “address” stands for the full address of the organisation.
    • “postCode” stands for the postal code of the organisation.
    • “postName” stands for the locality of the organisation.
    • “thoroughfare” stands for the number and street of the organisation.

Example of use: http://data.tbfy.eu/kg-api/organisation/gb-02183240

GET /organisation/{id}/award: This returns the list of awards that can be attached related to a specific organisation included in the knowledge graph. The list is displayed in JSON format and consists of the following model schema:

MODEL SCHEME FIELDS
{
"id": xsd:string,
“title”: xsd:string,
“description”: xsd:string,
“date”: xsd:dateTime,
“status”: xsd:string
}
  • “id” stands for the identifier of the award. It must be unique and must not change within the Open Contracting Process.
  • “title” stands for the title of the award.
  • “description” stands for the description of the award.
  • “date” stands for the date of the contract award. This is usually the date on which a decision to award was made.
  • “status” stands for the current status award from the closed awardStatus code list.

Example of use: http://data.tbfy.eu/kg-api/organisation/gb-02183240/award

GET /organisation/{id}/contractingProcess: This returns the list of contracting processes that can be attached related to a specific organisation included in the knowledge graph. The list is displayed in JSON format and consists of the following model schema:

MODEL SCHEME FIELDS
{
"id": xsd:string,
“releasePublishedDate”: xsd:dateTime
}
  • “id” stands for the identifier or the contracting process. It must be unique and must not change within the Open Contracting Process it is part. It also corresponds to the ocid.
  • "_creationDate" stands for the creation date of the triple.
    		•

    Example of use: http://data.tbfy.eu/kg-api/organisation/gb-02183240/contractingProcess

    Documentation of the core-API

    Resources

    Return to Home

    Clone this wiki locally