Invests endpoint

This section gives you information about invests in Goteo.org

/invests/

Obtains a list of invests.

curl -i --basic --user "user:key" https://api.goteo.org/v1/invests/

Filters available:

The standard set of filters) applies to this endpoint with these particulars:

Attribute Type Description
node string Filter by individual node(s). Multiple nodes can be specified. Restricts the list to the invests originally created in that node(s)
call string Filter by individual matchfunding call(s). Multiple calls can be specified. Restricts the list to the projects originally created in that call(s)
project string Filter by individual project(s). Multiple projects can be specified. Restricts the list to the invests that have either collaborate or contributed (financially) to that project(s).
from_date string Filter from date. Ex. "2013-01-01". Restricts the list to the invests created in that range
to_date string Filter until date.. Ex. "2014-01-01". Restricts the list to the invests created in that range
category integer Filter by project category. Multiple categories can be specified. Restricts the list to the invests that have interests in that category(ies)
location number Filter by project location (Latitude,longitude,Radius in Km). Restricts the list to the invests used in projects geolocated in that area
page integer Page number (starting at 1) if the result can be paginated
limit integer Page limit (maximum 50 results, defaults to 10) if the result can be paginated

Response values:

ResponseInvest
Attribute Type Description
extra ... ☞ ExtraInvest
items array ... ☞ Invest
meta ... ☞ MetaProject
ExtraInvest
Attribute Type Description
calls integer Number of matchfunding calls applying in the current query
pledged number Total sum pledged amount for the current query
projects integer Total sum of projects applying in the current query
refunded number Total sum of refunded amount for the current query
Invest
Attribute Type Description
amount number Amount of the contribution
call string Id of the matchfunding call if this invest belongs to a invest in selected
conversion-ratio number Currency rate at the moment of the payment (relative to EUR)
currency string Currency of the contribution (currently one of EUR, GBP, USD) in ISO 4217 format
date-charged string Date-only when the invest was charged in RFC822 format
date-created string Date-only when the invest was created in RFC822 format
date-returned string Date-only when the invest was returned (if applicable) in RFC822 format
date-updated string Date & Time when the invest was last updated in RFC822 format
id integer Invest unique identifier
latitude number Latitude coordinate for the invest
longitude number Longitude coordinate for the invest
project string Id of the invest where applies the invests
region string Region location for the invest
resign boolean True if the user does not want any reward in exchango of the contribution
status string Status of the payment, one of processing, pending, charged, cancelled, paid, returned, relocated, pool-returned
type string Type of the payment, one of payment, drop, pool
MetaProject
Attribute Type Description
category array Only if filtering by category
from_date string Only if filtering by from_date
lang array Only if filtering by lang
limit integer Limit of results per page when retrieving a collection
location array Only if filtering by location
node array Only if filtering by node
page integer Current page, 0 based (first page is zero)
project array Only if filtering by project
to_date string Only if filtering by to_date
total integer Total elements available for the collection

Response body:

{
  "extra": {
    "calls": 9,
    "pledged": 4344830.0,
    "projects": 804,
    "refunded": 224435.0
  },
  "items": [
    {
      "amount": 20.0,
      "call": null,
      "conversion-ratio": 1.0,
      "currency": "EUR",
      "date-charged": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-created": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-returned": null,
      "date-updated": "Mon, 23 Jan 2017 13:39:17 +0100",
      "id": 113374,
      "latitude": 40.40000000000000,
      "longitude": -3.68330000000000,
      "project": "cap-a-la-cooperativa-indigestio",
      "region": "Spain",
      "resign": false,
      "status": "charged",
      "type": "payment"
    },
    {
      "amount": 24.0,
      "call": null,
      "conversion-ratio": 1.0,
      "currency": "EUR",
      "date-charged": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-created": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-returned": null,
      "date-updated": "Mon, 23 Jan 2017 13:09:46 +0100",
      "id": 113373,
      "latitude": null,
      "longitude": null,
      "project": "playa-burbuja",
      "region": null,
      "resign": false,
      "status": "charged",
      "type": "payment"
    },
    {
      "amount": 32.0,
      "call": null,
      "conversion-ratio": 1.0,
      "currency": "EUR",
      "date-charged": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-created": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-returned": null,
      "date-updated": "Mon, 23 Jan 2017 12:33:32 +0100",
      "id": 113371,
      "latitude": 40.30570000000000,
      "longitude": -3.73290000000000,
      "project": "nuevo-album-de-freedonia",
      "region": "Madrid",
      "resign": false,
      "status": "charged",
      "type": "payment"
    },
    {
      "amount": 24.0,
      "call": null,
      "conversion-ratio": 1.0,
      "currency": "EUR",
      "date-charged": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-created": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-returned": null,
      "date-updated": "Mon, 23 Jan 2017 11:05:13 +0100",
      "id": 113370,
      "latitude": 40.41650000000000,
      "longitude": -3.70260000000000,
      "project": "playa-burbuja",
      "region": "Madrid",
      "resign": false,
      "status": "charged",
      "type": "pool"
    },
    {
      "amount": 20.0,
      "call": null,
      "conversion-ratio": 1.0,
      "currency": "EUR",
      "date-charged": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-created": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-returned": null,
      "date-updated": "Mon, 23 Jan 2017 10:13:04 +0100",
      "id": 113369,
      "latitude": 41.40077989999999,
      "longitude": 2.16030039999998,
      "project": "cap-a-la-cooperativa-indigestio",
      "region": "Barcelona",
      "resign": false,
      "status": "charged",
      "type": "payment"
    },
    {
      "amount": 60.0,
      "call": null,
      "conversion-ratio": 1.0,
      "currency": "EUR",
      "date-charged": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-created": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-returned": null,
      "date-updated": "Mon, 23 Jan 2017 10:04:06 +0100",
      "id": 113368,
      "latitude": null,
      "longitude": null,
      "project": "cap-a-la-cooperativa-indigestio",
      "region": null,
      "resign": false,
      "status": "charged",
      "type": "payment"
    },
    {
      "amount": 50.0,
      "call": null,
      "conversion-ratio": 1.0,
      "currency": "EUR",
      "date-charged": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-created": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-returned": null,
      "date-updated": "Mon, 23 Jan 2017 08:30:49 +0100",
      "id": 113367,
      "latitude": 41.39732730000001,
      "longitude": 2.12332409999999,
      "project": "nice-to-eat-you",
      "region": "Barcelona",
      "resign": false,
      "status": "charged",
      "type": "payment"
    },
    {
      "amount": 35.0,
      "call": null,
      "conversion-ratio": 1.0,
      "currency": "EUR",
      "date-charged": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-created": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-returned": null,
      "date-updated": "Mon, 23 Jan 2017 07:02:04 +0100",
      "id": 113366,
      "latitude": 37.38969100000000,
      "longitude": -6.12619250000000,
      "project": "nuevo-album-de-freedonia",
      "region": "Sevilla",
      "resign": false,
      "status": "charged",
      "type": "payment"
    },
    {
      "amount": 10.0,
      "call": null,
      "conversion-ratio": 1.0,
      "currency": "EUR",
      "date-charged": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-created": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-returned": null,
      "date-updated": "Mon, 23 Jan 2017 06:41:46 +0100",
      "id": 113365,
      "latitude": 43.40933960000000,
      "longitude": -3.80746220000003,
      "project": "sold-out",
      "region": "Cantabria",
      "resign": false,
      "status": "charged",
      "type": "payment"
    },
    {
      "amount": 50.0,
      "call": null,
      "conversion-ratio": 1.0,
      "currency": "EUR",
      "date-charged": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-created": "Mon, 23 Jan 2017 00:00:00 +0100",
      "date-returned": null,
      "date-updated": "Mon, 23 Jan 2017 06:09:04 +0100",
      "id": 113364,
      "latitude": 49.80286710000001,
      "longitude": 8.60353620000001,
      "project": "el-taller-movil",
      "region": "Darmstadt",
      "resign": false,
      "status": "charged",
      "type": "payment"
    }
  ],
  "meta": {
    "limit": 10,
    "page": 0,
    "total": 88384
  },
  "time-elapsed": 0.9609010219573975
}

/invests/{INVEST_ID}

Gets information about a single user.

curl -i --basic --user "user:key" https://api.goteo.org/v1/invests/1000

Filters available:

  • No filters are available in this endpoint
  • {INVEST_ID} must be the unique identifier of the user

Response values:

UserFull
Attribute Type Description
about string User's about text
amount-public-invested number Amount of money invested in any project (excluding anonymous investions)
date-created string Date when the user was created RFC822 format
id string User unique identifier
lang string Language for the user's texts description
name string Name of the user
node string Node where the user was created originally
profile-image-url string URL with the avatar (image) of the user
profile-url string URL for the user profile
projects-collaborated number Number of project the user has interacted
projects-public-invested number Number of projects where the user has invested (excluding anonymous investions)
projects-published number Number of project the user has created and published
translations array All available translations in a list indexed by language in ISO 639-1 format ☞ UserTranslation
UserTranslation
Attribute Type Description
about string User's about text translated (if any)
name string Name of the user translated (if any)

Response body:

{
  "about": "Este perfil representa al equipo que administra la plataforma Goteo, desde el que nos comunicamos con todos los usuarios y usuarias. Si quieres contactar con nosotras escribe desde la secci\u00f3n de \"Contacto\" (en el pie de la p\u00e1gina) o bien v\u00eda Twitter (@gteofunding)",
  "amount-public-invested": 0.0,
  "date-created": "Sat, 20 Aug 2011 13:57:14 +0200",
  "id": "goteo",
  "lang": "es",
  "name": "Goteo",
  "node": "goteo",
  "profile-image-url": "https://goteo.org/img/medium/goteo-twitter7r.png",
  "profile-url": "https://goteo.org/user/profile/goteo",
  "projects-collaborated": 7,
  "projects-public-invested": 0,
  "projects-published": 0,
  "time-elapsed": 0.03882288932800293,
  "translations": {
    "fr": {
      "name": null
    }
  }
}