What is ASP.NET Web API Attribute Routing?. The Complete ASP.NET Web API Developer Course 2023 [Videos].

In this Video, I am going to discuss ASP.NET Web API Attribute Routing with examples. As we already discussed in the ASP.NET Web API Routing Video that the Routing is a pattern matching mechanism to match an incoming HTTP Request to an action method of a controller.

Attribute Routing in ASP.NET Web API

The ASP.NET Web API 2 and ASP.NET MVC 5 supports a new type of routing called attribute routing. As the name implies, attribute routing means attributes are used to define routes. The Attribute routing provides more control over the URIs in your Web API application by defining routes directly on the actions and controllers. For example, you can easily create URIs that describes the hierarchies of resources.

The earlier style of routing called convention-based routing is still fully supported by ASP.NET Web API. In fact, you can combine both approaches in the same project. In this Video, we will discuss how to enable attribute routing in Web API and describes the various options for attribute routing.

Why do we need Web API Attribute Routing?

The first release of Web API uses the convention-based routing. In convention-based, we can define one or more route templates in the WebApiConfig file, which are basically parameterized strings. When the Web API Framework receives an HTTP request, it matches the URI against the route template that is available in the Route Table. For more information about convention-based routing, Please read the following Videos where we discussed the Convention based  with examples.

One advantage of convention-based routing is that all the URI templates are defined in a single place, and the routing rules are applied consistently across all the controllers.

But the convention-based routing in ASP.NET Web API makes it hard to support certain URI patterns that are common in RESTful APIs. For example, resources often contain child resources: Customers have orders, movies have actors, books have authors, etc. Its natural to create URIs that reflects these relations:

Lets understand this with an example.

Step1: Create a new Web API application. Name it AttributeRoutingInWEBAPI

Step2: Right-click on the “Models” folder and add a class file with the name Student.cs and then copy and paste the following code.

namespace AttributeRoutingInWEBAPI.Models
public class Student
public int Id { get; set; }
public string Name { get; set; }
Step3: Now, add Students Controller.

To do so Right-click on the Controllers folder and add a new Web API2 controller – Empty. Name it StudentsController.cs. Copy and paste the following code.

namespace AttributeRoutingInWEBAPI.Controllers
public class StudentsController : ApiController
static List<Student> students = new List<Student>()
new Student() { Id = 1, Name = "Pranaya" },
new Student() { Id = 2, Name = "Priyanka" },
new Student() { Id = 3, Name = "Anurag" },
new Student() { Id = 4, Name = "Sambit" }
public IEnumerable<Student> Get()
return students;
public Student Get(int id)
return students.FirstOrDefault(s => s.Id == id);
public IEnumerable<string> GetStudentCourses(int id)
List<string> CourseList = new List<string>();
if (id == 1)
CourseList = new List<string>() { "ASP.NET", "C#.NET", "SQL Server" };
else if (id == 2)
CourseList = new List<string>() { "ASP.NET MVC", "C#.NET", "ADO.NET" };
else if (id == 3)
CourseList = new List<string>() { "ASP.NET WEB API", "C#.NET", "Entity Framework" };
CourseList = new List<string>() { "Bootstrap", "jQuery", "AngularJs" };
return CourseList;

In Web API1, we had the convention-based routing that defines the routes using the route templates. When we create a new Web API project the Web API Framework creates a default route in the WebApiConfig.cs file. The default route is shown below

Attribute Routing in WEB API

So with the above default route and the StudentsController in place /api/students is mapped to the Get() method of StudentsController as expected as shown in the below image.

Attribute Routing in WEB API

But when we navigate to /api/students/1 we get the following exception message

Multiple actions were found that match the request: Get on type AttributeRoutingInWEBAPI.Controllers.StudentsController GetStudentCourses on type AttributeRoutingInWEBAPI.Controllers.StudentsController

This is because the Web API Framework does not know which of the 2 following action methods to map to the URI /api/students/1

Get(int id) or GetStudentCourses(int id)

This can be very easily achieved by using the Attribute Routing in ASP.NET Web API. Here is what we want the Web API Framework to do

  1. URI /api/students/1 should be mapped to Get(int id). This method should return the student by id.
  2. The URI /api/students/1/courses should be mapped to GetStudentCourses(int id). This method should return the student courses by student id.

To achieve the above, we need to decorate the GetStudentCourses() action method with the [Route] attribute as shown in the below image

Attribute Routing in WEB API

At this point build the solution and navigate to /api/students/1. Notice that, now you will get the student details whose id=1 and when you navigate to /api/students/1/courses you will get all the courses into which student with id=1 is enrolled. Let us see some of the examples where attribute routing makes it easy.

API versioning

In the below example, the route “/api/v1/students” would be routed to a different controller than the “/api/v2/students” route.

Overloaded URI segments

In this example, “1” is an order number, but “pending” maps to a collection.

Multiple parameter types

In this example, “1” is an order number, but “2013/06/16” specifies a date.

How to enable Web API Attribute Routing?

In Web API 2, the Attribute Routing is enabled by default. The config.MapHttpAttributeRoutes(); code which is present in WebApiConfig.cs file enables the Web API Attribute Routing. We can also combine the Web API Attribute Routing with convention-based routing. To define convention-based routes, call the MapHttpRoute method as shown below.

Attribute Routing in WEB API

Can we use both Attribute Routing and Convention-based routing in a single Web API project?

Yes, We can combine both the routing mechanisms in a single ASP.NET Web API project. The controller action methods that have the [Route] attribute uses the Attribute Routing and the others without [Route] attribute uses Convention-based routing.

Note: You need to configure the Attribute routing before the convention-based routing in ASP.NET Web API.

What are the advantages of using Web API Attribute Routing?
  1. It gives us more control over the URIs than convention-based routing. Creating URI patterns like hierarchies of resources (For example, students have courses, Departments have employees) is very difficult with convention-based routing.
  2. Reduces the chances for errors, if a route is modified incorrectly in RouteConfig.cs then it may affect the entire applications routing.
  3. May decouple controller and action names from route entirely.
  4. Easy to map two routes pointing to the same action.

See All

Comments (327 Comments)

Submit Your Comment

See All Posts

Related Posts

ASP.NET Web API / Blog

What is ASP.NET Web API Application?

In this ASP.NET Web API Tutorials series, I covered all the features of ASP.NET Web API. You will learn from basic to advance level features of ASP.NET Web API. The term API stands for “Application Programming Interface” and ASP.NET Web API is a framework provided by Microsoft which makes it easy to build Web APIs, i.e. it is used to develop HTTP-based web services on the top of .NET Framework.
3-Feb-2022 /34 /327

ASP.NET Web API / Blog

How to creat ASP.NET Web API Application using Visual Studio?

In this article, I am going to discuss the step-by-step procedure for Creating ASP.NET Web API Application. Please read our previous article before proceeding to this article where we gave an overview of the ASP.NET Web API framework. As part of this article, we ate going to discuss the following pointers.
3-Feb-2022 /34 /327

ASP.NET Web API / Blog

How to add Swagger in Web API Application?

In this article, I am going to discuss how to add Swagger in Web API Application to document and test restful Web API services. Please read our previous article where we discussed How to Create an ASP.NET Web API Application step by step before proceeding to this article as we are going to work with the same example. As part of this article, we are going to discuss the following pointers.
3-Feb-2022 /34 /327