Main Navigation Guide Rest API Wiki

English

Deutsch

English

Deutsch

Appearance

Sidebar Navigation

API Reference

achievement

GET Get all achievements that belong to a region

POST Add a new achievement

DELETE Delete an existing achievement

PATCH Edit an existing achievement

GET Get details about all users that have a specific achievement

POST Award an achievement to a user

DELETE Revoke an achievement from a user

PATCH Edit the awarded achievement of a user

activities

GET Returns the filters for all dashboard activities for the current user

PATCH Sets which dashboard activities should be deactivated for the current user.

GET Returns the updates object for ActivityOverview to display on the dashboard

application

DELETE Declines an application for a work group.

PATCH Accepts an application for a work group.

GET Returns all pending applications for a working group.

banana

PUT Gives a banana to a user

DELETE DELETE /api/user/{recipientId}/banana/{senderId}

GET Returns basic metadata about the bananas of a user

GET Returns the bananas given to a user

GET Returns the bananas given by a user

basket

GET Returns all current baskets of the user.

GET Returns a list of baskets close to a given location. If the location is not valid the user's home location is used. The distance is measured in kilometers.

GET Returns details of the basket with the given ID. Returns 200 and the basket, 500 if the basket does not exist, or 401 if not logged in.

PUT Updates the description of an existing basket. The description must not be empty. If the location is not given or invalid it falls back to the user's home. Returns the updated basket.

DELETE Removes a basket of this user with the given ID. Returns 200 if a basket of the user was found and deleted, 404 if no such basket was found, or 401 if not logged in.

POST Adds a new basket. The description must not be empty. All other parameters are optional. Returns the created basket.

POST Requests a basket.

POST Withdraw a basket request.

bells

GET Returns all bells for the current user.

DELETE Deletes a bell.

PATCH Marks one or more bells as read.

blog

GET Returns a page from the list of blog posts. The page can be empty if the page number is too large.

POST Publishes a new blog post. The post will be publicly visible immediately.

GET Returns a specific blog post.

DELETE Removes one blogpost from the database.

PATCH PATCH /api/blog/{blogId}

PATCH PATCH /api/blog/{blogId}/publish

buddy

PUT Sends a buddy request to a user.

DELETE Removes a buddy request to a user.

calendar

GET Returns the user's current access token.

PUT Creates a new random access token for the user. An existing token will be overwritten. Returns the created token.

DELETE Removes the user's token. If the user does not have a token nothing will happen.

GET Returns the user's future foodsharing dates as iCal.

content

GET Returns a list of all content entries.

POST Adds a new content entry

GET Returns the content entry for a specific id.

DELETE Deletes the content entry with the specific id.

PATCH PATCH /api/content/{contentId}

donation

GET Returns cached information of foodsharing donation-goal via third service provider twingle.

events

PATCH Updates the user's response to an invitation.

GET List events for region and groups.

POST Add a new event.

PATCH PATCH /api/events/{eventId}

featuretoggle

GET Returns all feature toggle identifiers with some information.

GET Checks if a feature toggle is active or not.

POST Toggles a feature toggle state.

foodSharePoints

GET Returns a list of food share points close to a given location

GET Returns details of the food share point with the given ID.

DELETE DELETE /api/foodSharePoints/{foodSharePointId}

PATCH Edit an existing food share point.

GET Returns a list of all food share points in a region and all its subregions.

POST Adds or suggests a new food share point.

GET GET /api/foodSharePoints/{foodSharePointId}/permissions

POST POST /api/foodSharePoints/{foodSharePointId}/follow

DELETE DELETE /api/foodSharePoints/{foodSharePointId}/follow

POST POST /api/foodSharePoints/{foodSharePointId}/accept

foodsaver

GET Lists all pickups into which a user is signed in on a specific day, including unconfirmed ones.

forum

GET Gets available threads including their last post.

POST Create a thread inside a forum.

GET Get a single forum thread including some of its messages.

DELETE Deletes a forum thread.

PATCH Change attributes for a thread: Stickiness, activate thread, status.

POST Create a post inside a thread.

POST request email notifications for activities in at thread.

DELETE Remove email notifications for activities in a thread.

POST request bell notifications for activities in a thread.

DELETE Remove bell notifications for activities in a thread.

DELETE Delete a forum post.

GET Get details on a hidden forum post

DELETE Restore a hidden forum post

PATCH Hide a forum post.

POST Adds an emoji reaction to a post. An emoji is an arbitrary string but needs to be supported by the frontend.

DELETE Remove an emoji reaction the logged in user has given from a post.

groups

DELETE Delete a region or a working group.

PATCH Updates the properties of a group.

GET Returns the join URL of a given groups conference.

GET Returns a list of all groups of the user.

POST Adds a member to a working group. If the user is already a member of the group, nothing happens. This endpoint can be used for adding someone else to a working group if you are allowed to edit that group or for joining a group if you allowed to do so.

POST Sends a message to a group via email, including a custom message from the contact form.

POST Requests to join a group and provides motivation, ability, experience, and selected time message for mail to group.

my

GET Returns a list of all region of the user.

locale

GET Returns the locale setting for the current session.

POST Sets the locale for the current session.

mailbox

DELETE Moves an email to the trash folder or deletes it, if it is already in the trash.

PATCH Changes properties of an email. This does not care about the previous status, i.e. setting a property to the same value as before will still result in a success response.

GET Returns the number of unread mails for the sending user.

GET Returns all mails from mailbox.

GET Return mail from mailbox.

POST Send email from mailbox.

GET Returns all regions and their email addresses.

map

GET Returns the coordinates of all baskets.

GET Returns the data for the bubble of a community marker on the map.

GET Returns the data for a FoodSharePoint.

GET Returns the data for the bubble of a basket marker on the map.

GET Returns the data for the bubble of a store marker on the map.

conversation

POST POST /api/conversations/{conversationId}/readStatus

GET GET /api/conversations/{conversationId}/messages

POST POST /api/conversations/{conversationId}/messages

GET GET /api/conversations/{conversationId}

PATCH PATCH /api/conversations/{conversationId}

GET GET /api/conversations

POST POST /api/conversations

DELETE DELETE /api/conversations/{conversationId}/members/{userId}

GET GET /api/user/{userId}/conversation

newsletter

POST Sends a test newsletter email to the given address. Returns 200 on success, 401 if the current user may not send newsletters, or 400 if the email address is invalid.

notifications

GET Returns notifications for specific target parameter.

PATCH Update notification state for regions or working groups.

PATCH Set or disable notification for forum threads.

PATCH Set or disable notification for foodSharePoints.

PATCH Activate or disable the newsletter or mail notification for chat.

PATCH Activate or pickup reminder mail.

PATCH Activate or disable the mention notifications.

pickup

POST POST /api/stores/{storeId}/pickups/{pickupDate}/{fsId}

DELETE Remove a user from a pickup.

PATCH PATCH /api/stores/{storeId}/pickups/{pickupDate}/{fsId}

DELETE Remove a user from all his pickups.

GET Return the regular pickups for an store.

GET GET /api/stores/{storeId}/pickups

GET GET /api/stores/{storeId}/history/{fromDate}/{toDate}

GET Get past pickups of a user.

GET Get all future pickups a user has registered.

GET Get all pickup options a user has, including already registered slots.

GET Validation of PickupRuleCheck.

stores

PUT Configures the regular pickups for a store.

PATCH Creates or modifies a manual pick up for an store.

GET Returns all common metadata which are required to manage stores.

GET Returns a list of stores where the user is a member of reduced store information.

GET Provides store identifiers for stores of a region.

POST Creates a new store.

GET Provides store information, contacts and options for a store id.

PATCH Allows to patch the store with information like the store team status.

GET Provides store members.

GET Provides store permissions.

GET Returns details of the store with the given ID. Returns 200 and the store, 404 if the store does not exist, or 401 if not logged in.

GET Provides a list of all foodsaver related stores and the next picks status.

GET Get applications to store team.

POST Request to join a store team.

DELETE Removes the user's own request or denies another user's request for a store.

PATCH Accepts a user's request for joining a store.

POST Adds user to store team, without a request to join from that user.

DELETE Removes user from store team.

DELETE Demotes a user from store manager to regular store team member.

PATCH Promotes a user to store manager.

DELETE Moves a store-team member from the standby team to the regular team.

PATCH Moves a store-team member from the regular team to the standby team.

GET Returns an array of log entries with foodsaver and log information.

pushnotification

GET GET /api/pushnotification/{type}/server-information

POST POST /api/pushnotification/{type}/subscription

DELETE DELETE /api/pushnotification/{type}/subscription/{subscriptionId}

quiz

POST POST /api/user/current/quizsessions/{quizId}/start

GET GET /api/user/current/quizsessions/{quizId}/status

GET GET /api/user/current/quizsessions/{quizId}/question

POST POST /api/user/current/quizsessions/{quizId}/answer

GET GET /api/user/current/quizsessions/{quizId}/results

POST POST /api/user/current/quizsessions/{quizId}/confirm

GET GET /api/quiz/sessions/{foodsaverId}

DELETE DELETE /api/quiz/session/{sessionId}

GET GET /api/quiz/{quizId}

PATCH PATCH /api/quiz/{quizId}

GET GET /api/quiz/{quizId}/questions

POST POST /api/quiz/{quizId}/questions

DELETE DELETE /api/quiz/{quizId}/questions/{questionId}

PATCH PATCH /api/quiz/{quizId}/questions/{questionId}

POST POST /api/quiz/{quizId}/questions/{questionId}/answers

DELETE DELETE /api/quiz/{quizId}/questions/{questionId}/answers/{answerId}

PATCH PATCH /api/quiz/{quizId}/questions/{questionId}/answers/{answerId}

region

POST POST /api/region/{regionId}/join

POST Removes the current user from a region. Returns 403 if not logged in, 400 if the region does not exist, 409 if the user is still an active store manager in the region, or 200 if the user was removed from the region or was not a member of that region. That means that after a 200 result the user will definitely not be a member of that region anymore.

GET Returns the region options for a specific region.

POST Sets the options for region.

GET Returns the coordinates and description for a region's pin

POST Sets the pin for region.

GET Returns a list of all subregions including working groups of a region.

GET Returns a list of all members for a region.

DELETE DELETE /api/region/{regionId}/members/{memberId}

POST Sets an user as Admin / Ambassador of a region / workgroup.

DELETE Sets an user as Admin / Ambassador of a region / workgroup.

GET Returns the permissions that this user has concerning administration of the members in the region.

GET Returns the properties of a specific region.

PATCH PATCH /api/region/{regionId}

POST POST /api/region

report

GET GET /api/report/region/{regionId}

GET GET /api/report/user/{userId}

POST Adds a new report. The reportedId must not be empty.

search

GET Search for users.

GET General search endpoint that returns all kinds of searchable entry types.

GET Returns search index for quick local search of likely searched entities.

GET Search in the titles of forum threads in a specific group.

user

PATCH Sets the current user's sleep mode. For the temporary mode, both 'from' and 'to' need to be given. Both are assumed to be in the format 'd.m.Y'. For other modes the two fields will be ignored. Optionally, a message can be added.

PATCH Requests that the user's login email address will be changed. This does not permanently change the address yet, but sends out the confirmation email. Every user can change the own email address. Changing someone else's address requires certain permissions.

PATCH Allows users to change their own password.

GET Checks if the user is logged in and lists the basic user information. Returns 200 and the user data, 404 if the user does not exist, or 401 if not logged in.

GET Checks if the user is logged in and lists the basic user information. Returns 401 if not logged in or 200 and the user data.

GET Lists the detailed profile of the current user. Returns 401 if not logged in or 200 and the data.

POST POST /api/user/login

POST POST /api/user/logout

POST Tests if an email address is valid for registration. Returns 400 if the parameter is not an email address or 200 and a 'valid' parameter that indicates if the email address can be used for registration.

POST Registers a new user.

DELETE DELETE /api/user/{userId}

PATCH Sets a previously uploaded picture as the user's profile photo.

DELETE Removes the user from the email bounce list. This will have no effect and return 200 if the user was not on the bounce list.

PATCH Updates the user profile information.

statistics

GET Returns the gender distribution from a region.

GET Returns the age band distribution from a region.

storecategories

GET Returns all existing store categories

POST Adds a store category

DELETE DELETE /api/storecategories/{id}

PATCH Changes a store category

chain

GET Returns the list of store chains.

POST Creates a new store.

GET Returns a specific store chain.

PATCH Updates a store.

GET Returns the list of stores that are part of a given chain.

support

POST Creates a new support ticket

upload

GET Returns the image with the requested UUID. Width and height must both be given or can be set both to 0 to indicate no resizing.

GET GET /api/uploads/{uuid}/metadata

POST POST /api/uploads

verification

DELETE Changes verification status of one user to 'deverified'.

PATCH Changes verification status of one user to 'verified'.

GET Returns a list of the user's past (de-)verifications.

GET Returns a list of the times the user's pass was created.

POST User can create own passport

POST Ambassador can create passports for users in region

polls

GET Returns the details of a poll.

DELETE Deletes a poll.

PATCH Updates an existing poll. This can change a poll's title, description, and options. Updating is only possible within one hour after creation.

GET Lists all polls in a region or working group.

GET Lists all polls the user is invited to.

PUT Vote in a poll. The options need to be a list mapping option indices to the vote values (+1, 0, -1). Depending on the voting type not all options need to be included.

POST Creates a new poll. The poll and all its options will be assigned valid IDs and option indices by the server. Options must be passed as an array of strings for the options' texts. The order of the options will be kept.

wall

GET Get posts of a wall.

POST Add a post to a wall.

DELETE Delete a post from a wall.

DELETE DELETE /api/report/{reportId}

GET GET /api/user/names/{userIds}

GET Returns the wallet URL for the current user

On this page

Foodsharing API

Requests manipulating data need to supply a CSRF token

Edit this page

Pager

Next page GET Get all achievements that belong to a region

Foodsharing API ​

Foodsharing API