City, Gdańsk Getting Started: Account, Keys, First Request (2026)

Getting started overview

Engaging with the City of Gdańsk's digital resources primarily involves navigating its official website, which serves as the central hub for citizen services, public information, and open data access. Unlike commercial API platforms that offer extensive programmatic interfaces, the City of Gdańsk focuses on providing information and services directly to residents and visitors through its web presence. Developers interested in utilizing city data will find opportunities within specific open data initiatives, which may involve direct downloads or specialized access methods rather than a unified API key system.

The initial steps involve understanding the structure of the official Gdańsk website to locate relevant services or data sets. For general citizen services, users interact directly with web forms and information pages. For access to open data, the process can vary depending on the specific dataset's availability and requirements. This guide will outline the general approach to getting started, focusing on how to find information and, where applicable, how to register for services or data access.

The table below provides a quick reference for the essential steps to begin interacting with the City of Gdańsk's online environment:

Create an account and get keys

The City of Gdańsk does not operate a unified developer portal requiring a single API key for all services, unlike commercial platforms such as Stripe API keys or AWS access keys. Instead, access to digital services and data is managed on a per-service or per-dataset basis. For general citizen services, such as submitting applications or checking status, you may need to create an account on specific sub-platforms within the gdansk.pl domain.

Creating a Citizen Account

If you intend to use personalized online services, such as e-administration forms or applications that require identity verification, you will likely need to register for a citizen account. This typically involves:

1. Visiting the relevant service page: Navigate to the specific service you wish to use on the Gdańsk citizen services section.
2. Locating the registration option: Look for links such as "Register," "Create account," or "Log in with trusted profile (Profil Zaufany)."
3. Providing necessary information: This usually includes personal details, email address, and setting a password. For services requiring higher assurance, you might need to use a Polish Trusted Profile (Profil Zaufany), which is a common method for electronic identification in Polish public administration.
4. Email verification: After registration, you will typically receive an email to verify your address.

Accessing Open Data

For open data, the City of Gdańsk supports transparency initiatives, providing public datasets that may be available for direct download without specific API keys. You should:

1. Search the official website: Look for sections explicitly named "Open Data," "Public Information," or "Statistics."
2. Review dataset descriptions: Each dataset will typically have its own terms of use and access methods. Some may be simple CSV or XML file downloads, while others might offer rudimentary APIs (e.g., direct links to JSON feeds) without requiring formal authentication.
3. Check for usage policies: Even for publicly available data, it's crucial to review any associated licenses or usage policies to ensure compliance with data governance standards, similar to how organizations like ArcGIS Open Data provide guidelines.

At present, the City of Gdańsk does not provide a programmatic API key system for developers that grants broad access across multiple city services. Access is generally granular and often requires either direct website interaction or adherence to specific terms for individual open datasets.

Your first request

Since the City of Gdańsk does not offer a unified API with a single authentication method like an API key, a "first request" will depend on the specific type of interaction you intend to have. This section will cover two primary scenarios: making a request via a web form for a citizen service and accessing a public open data resource.

Scenario 1: Submitting a Citizen Service Request (Web Form)

Many interactions with the City of Gdańsk involve filling out online forms. Let's consider a common example, such as reporting a local issue or submitting an application for a document.

1. Navigate to the service: Go to the Gdańsk citizen service portal and select the specific service, e.g., "Report a street defect."
2. Log in or proceed as guest: If the service requires an account, log in using your previously registered credentials or your Profil Zaufany. Some simple reports might allow guest submissions.
3. Fill out the form: Complete all required fields. This might include details like location, description of the issue, contact information, and attaching relevant files (e.g., photos).
4. Submit the form: Click the "Submit" or "Send" button. You should receive a confirmation message on the screen and often via email, indicating that your request has been successfully submitted. This confirmation serves as the "success response" for your interaction.

This web-based interaction is the most common form of "first request" for direct citizen engagement with the City of Gdańsk.

Scenario 2: Accessing Open Data (Direct Download or Simple API Call)

For developers or researchers, accessing open data is a common "first request." While not a complex API, it represents an initial programmatic or data-retrieval interaction.

Suppose you want to access a public dataset, for instance, public transport schedules or demographic statistics, if available as open data.

1. Locate the open data section: Search gdansk.pl for "otwarte dane" (open data) or "statystyki" (statistics).
2. Identify a dataset: Find a dataset explicitly marked for public access, for example, a CSV file of bus stops.
3. Perform the download: Click the download link provided for the dataset. For example, if a dataset is offered as a JSON endpoint (e.g., https://www.gdansk.pl/data/bus_stops.json), you can make a simple HTTP GET request using tools like curl or a web browser to retrieve the data.

curl -X GET "https://www.gdansk.pl/api/v1/public-transport/stops" \ 
  -H "Accept: application/json"

(Note: The above URL is illustrative; actual open data endpoints may vary and require specific discovery on the Gdańsk website. Always refer to the official Gdańsk documentation for accurate endpoints.)

A successful "first request" in this context means you have successfully downloaded the data file or received a valid JSON/XML response, indicating that the public endpoint is accessible and returning data.

Common next steps

After successfully interacting with the City of Gdańsk's digital resources, whether through a web form or by accessing open data, several common next steps can enhance your engagement:

• Explore more citizen services: The Gdańsk citizen services portal offers a wide array of online forms and information. Familiarize yourself with services related to residency, taxes, permits, and public amenities.
• Monitor service status: If you submitted a request or application that generates a case number, regularly check the status through the designated online tracking system, if available. This is a standard feature in many e-government platforms.
• Engage with open data further: If you're a developer or data analyst, continue exploring the available open datasets. Consider integrating them into local applications, visualizations, or research projects. Always ensure compliance with any data usage licenses, as outlined by the IETF's guidelines on URI usage for data sources.
• Subscribe to city newsletters: Stay informed about city news, events, and new digital initiatives by subscribing to official newsletters from gdansk.pl.
• Provide feedback: Many public service portals offer feedback mechanisms. Providing constructive comments can help improve the quality and accessibility of digital services.
• Utilize mobile applications: Check if the City of Gdańsk offers official mobile applications for specific services (e.g., public transport, parking, event guides). These apps often provide a more streamlined user experience for common tasks.
• Participate in public consultations: The city often hosts online public consultations on urban planning, budget allocation, or new policies. Participating in these can influence local decision-making.

Troubleshooting the first call

Troubleshooting issues when interacting with the City of Gdańsk's digital services primarily involves addressing common web-based problems, as a complex API interaction with specific error codes is less common. Here are typical issues and their resolutions:

• Website Not Loading:
  • Check internet connection: Ensure your device has a stable internet connection.
  • Clear browser cache and cookies: Outdated cached data can sometimes interfere with website loading. Clear them and try again.
  • Try a different browser: Browser compatibility issues can occur. Test with another modern web browser (e.g., Chrome, Firefox, Edge).
  • Check official announcements: Look for any notices on the city's social media or main page about website maintenance or outages.
• Login Issues for Citizen Account:
  • Verify credentials: Double-check your username/email and password for typos.
  • Password reset: Use the "Forgot password" or "Reset password" link if available.
  • Account activation: Ensure your account has been activated via the email verification link sent during registration.
  • Trusted Profile (Profil Zaufany) issues: If using Profil Zaufany, ensure it is active and correctly linked. Issues with Profil Zaufany might require contacting the national e-administration support.
• Form Submission Errors:
  • Missing required fields: Review the form carefully for any fields marked as mandatory that you might have missed.
  • Invalid data format: Ensure all data (dates, phone numbers, etc.) adhere to the specified format. Look for inline error messages.
  • File upload limits: If attaching files, check for size or type restrictions.
  • Server timeout: For very large forms or slow connections, the submission might time out. Try again with a more stable connection or during off-peak hours.
• Open Data Access Issues (if using a direct URL):
  • Incorrect URL: Verify that the URL for the open data resource is exactly as provided by the City of Gdańsk. Typos are common.
  • Resource moved or removed: Public data sources can sometimes be updated or decommissioned. Check the official open data portal for current links.
  • Firewall/Proxy interference: If you're behind a corporate firewall or proxy, it might be blocking access to certain external resources. Consult your network administrator.
  • Rate limiting (rare but possible): While unlikely for simple GET requests on public data, excessive automated requests might trigger temporary blocks. Adhere to any stated usage policies.
• General Support:
  • If problems persist, look for a "Contact Us" or "Help" section on the Gdańsk website. They usually provide contact forms, email addresses, or phone numbers for technical support related to their online services.