Negotiable
Undetermined
Hybrid
Greater Edinburgh Area
Summary: The Business Analyst role focuses on API design and documentation, specifically utilizing Swagger/OpenAPI. The candidate will collaborate with various stakeholders to gather requirements and ensure that API specifications align with both business and technical needs. This position requires a strong understanding of JSON structures and involves working in a hybrid model with 2-3 days onsite. The role is contract-based and situated in the Greater Edinburgh Area.
Key Responsibilities:
- Work with stakeholders to gather and define business and functional requirements.
- Translate business requirements into technical interface specifications (JSON-based).
- Create and maintain Swagger/OpenAPI specifications for RESTful APIs.
- Collaborate with the development team to ensure accurate implementation of interfaces.
- Participate in backlog grooming, sprint planning, and reviews in Agile ceremonies.
- Ensure consistency, accuracy, and version control in interface documentation.
- Support QA teams with understanding of APIs and expected data flows.
- Work with UI/UX and backend teams to align contract-first API development.
Key Skills:
- Strong understanding of API design and documentation.
- Proficiency in JSON structures.
- Experience with Swagger/OpenAPI specifications.
- Ability to gather and define business and functional requirements.
- Familiarity with Agile methodologies.
- Collaboration skills with development, QA, and UI/UX teams.
Salary (Rate): undetermined
City: Greater Edinburgh Area
Country: United Kingdom
Working Arrangements: hybrid
IR35 Status: undetermined
Seniority Level: undetermined
Industry: Other
Job Title: Business Analyst – API/Swagger Documentation
Location: Edinburg
Work Mode: Hybrid 2–3 days onsite
Contract Type: Contract
Job Summary: We are looking for a highly skilled Business Analyst with a strong understanding of API design, JSON structures, and Swagger/OpenAPI documentation. The ideal candidate will work closely with product owners, developers, and testers to elicit requirements, document technical interfaces, and ensure that API specifications meet business and technical needs.
Key Responsibilities:
- Work with stakeholders to gather and define business and functional requirements.
- Translate business requirements into technical interface specifications (JSON-based).
- Create and maintain Swagger/OpenAPI specifications for RESTful APIs.
- Collaborate with the development team to ensure accurate implementation of interfaces.
- Participate in backlog grooming, sprint planning, and reviews in Agile ceremonies.
- Ensure consistency, accuracy, and version control in interface documentation.
- Support QA teams with understanding of APIs and expected data flows.
- Work with UI/UX and backend teams to align contract-first API development.